Aperçu seulement — activation requise

Téléchargements de construction avec EasyF

EasyF affiche l'interface à l'avance afin que les développeurs puissent estimer leur travail. Une revue de support est toujours requise avant qu'une clé active et une limite d'utilisation existent.

EasyfClientJSON sur HTTPSTravaux asynchronesScoped credentials

Démarrage rapide

Pour expliquer l'hôte API, EasyF sépare les identifiants activés par le support d'un point de terminaison locataire assigné. Un flux de travail en langage clair donne à un chemin d'appel serveur uniquement sa propre place.

URL du locatairehttps://easyf.app

AuthentificationX-API-Key: pending_activation_…

Profil du clientEasyfClient

Version de l'APIv1

# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"

curl -X POST https://easyf.app/v1/resolve \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

La sécurité des identifiants commence par le stockage secret côté serveur sur EasyF. La vue suivante couvre l'absence d'intégration de bundle client. La page ne conserve aucun journal public ni dépôt visible.

Résoudre un lien

Pour expliquer l'opération Resolve, EasyF sépare la détection de la source des formats d'une URL soumise. Un flux de travail en langage clair ne donne pas de place à des sorties inventées.

POST/v1/resolvePortée: résoudre

SUR LE TERRAIN	Type de	Requis	Description
`asset_url`	URL HTTPS	Oui	Page média publique ou autorisée à analyser.
`tenant`	string	Non	Domaine du locataire affecté. Généralement omis.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

L'identifiant de format commence par la valeur retournée inchangée sur EasyF. La vue suivante couvre la disponibilité par lien. La page ne garde aucune étiquette de qualité deviné visible.

Créer et suivre une tâche de téléchargement

EasyF présente trois points pratiques pour la création d'emplois. Le premier est la préparation asynchrone. Le flux de travail en langage clair couvre ensuite une courte requête HTTP. Son dernier point est l'exécution limitée des travailleurs.

POST/v1/jobsPortée: emplois

SUR LE TERRAIN	Type de	Requis	Description
`asset_url`	URL HTTPS	Oui	La même source normalisée soumise à résoudre.
`variant_code`	string	Oui	Un ID exact de la réponse de résolution.
`tenant`	string	Non	Domaine du locataire affecté. Généralement omis.

curl -X POST https://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'

1202 AcceptéesEnregistrer delivery_id.

2État du sondageGET /v1/jobs/{delivery_id} avec la même clé.

3PrêtOuvrez l'URL de téléchargement signée.

État d ' avancement	Signification	Action du client
`queued`	Admis dans la file d'attente limitée.	Sondage à nouveau avec backoff.
`extracting`	Actualisation des métadonnées source ou de l'itinéraire.	Continuez à voter.
`processing`	Téléchargement, remixage ou fusion.	Afficher la progression du serveur.
`ready`	Téléchargement signé est disponible.	Envoyez l'URL à l'utilisateur.
`failed`	Erreur structurée terminale.	Lire `error_code`. Réessayez seulement quand conseillé.
`expired`	La sortie temporaire a été supprimée.	Créer un nouveau job.

curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF aborde le sondage des tâches par une attente initiale d'une seconde, puis un retour en arrière plafonné. Le flux de travail en langage clair maintient la livraison signée temporaire explicite.

Les erreurs prévisibles

EasyF organise le contrat d'erreur autour d'une seule enveloppe non 2xx. Son flux de travail en langage clair compare un ID de demande de support. La gestion client prévisible reste la vérification finale.

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

HTTP	Signification typique	Action
400	URL, corps ou format non valide.	Corrigez la requête. Résolvez à nouveau pour les formats.
401	Clé manquante, invalide, expirée ou de mauvaise portée.	Vérifiez les informations d'identification côté serveur.
403	La politique du locataire ou de la source a rejeté la demande.	Ne contournez pas la politique. Contactez le support.
404	Offre d'emploi inconnue ou expirée.	Créez une nouvelle tâche si nécessaire.
429	Limite de demandes ou de tâches actives atteinte.	Honor `retry_after_seconds`.
503	File d'attente/capacité ou amont temporairement indisponible.	Réessayez avec un décalage et une gigue exponentiels.

Contrat d ' exploitation

EasyF s'accorde sur des limites d'utilisation pratiques avec chaque produit approuvé pour préserver un flux de travail guidé prévisible.

Utilisez une logique d'application idempotente et ne démarrez jamais de tâches en double pour le même clic utilisateur.
Le cache résout brièvement les métadonnées, mais traite toujours les URL de téléchargement signées comme expirant.
Utiliser un décalage exponentiel limité avec gigue pour 429, 503 et erreurs retentables.
Traitez uniquement les médias publics ou les médias auxquels vous êtes autorisé à accéder. Les contrôles DRM et d'accès ne sont pas contournés.
Conservez les ID de requête et les ID de tâche dans des journaux opérationnels privés.

Pour expliquer l'accès au Schéma, EasyF sépare l'activation avant l'exploration de l'authentification assignée. Un flux de travail en langage clair donne aux formes de demande documentées leur propre place.

ACCÈS RÉVISÉ PAR L'OPÉRATEUR

Activer par le biais du support

Dites à EasyF ce que vous construisez, à quelle fréquence il appellera l'API et quels fournisseurs sont importants. La revue décide des opérations autorisées, puis révèle un identifiant une seule fois tout en ne sauvegardant que son résumé sécurisé.

Demande d'activation Les clés sont limitées à la portée du client, révocables et émises via le formulaire de contact.