Aperçu seulement — activation requise

Téléchargements de construction avec FFast

FFast expose la forme d'API prévue sans activer les appels publics. Un opérateur active les informations d'identification et les quotas mesurés après avoir examiné l'intégration proposée.

FfastPipelineJSON sur HTTPSTravaux asynchronesScoped credentials

Démarrage rapide

FFast s'approche de l'hôte API via des informations d'identification activées par le support, puis un point de terminaison de client affecté.

URL du locatairehttps://ffast.app

AuthentificationX-API-Key: pending_activation_…

Profil du clientFfastPipeline

Version de l'APIv1

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

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

Pour la sécurité des informations d'identification, FFast vérifie le stockage secret côté serveur avant l'intégration du bundle client.

Résoudre un lien

FFast aborde l'opération Resolve par la détection de la source, puis les formats à partir d'une URL soumise.

POST/v1/resolvePortée: résoudre

SUR LE TERRAIN	Type de	Requis	Description
`fast_source`	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
}

Pour l'identifiant Format, FFast vérifie la valeur retournée inchangée avant la disponibilité par lien. Cette revue rapide ne permet pas non plus de deviner l'étiquette de qualité.

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

FFast gère la création de tâches en identifiant d'abord la préparation asynchrone, puis en envoyant une courte requête HTTP et en gardant à l'esprit l'exécution de worker limité.

POST/v1/jobsPortée: emplois

SUR LE TERRAIN	Type de	Requis	Description
`fast_source`	URL HTTPS	Oui	La même source normalisée soumise à résoudre.
`output_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://ffast.app/v1/jobs \
  -H "X-API-Key: $FFAST_PIPELINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID","output_code":"18"}'

1202 AcceptéesEnregistrer pipeline_run.

2État du sondageGET /v1/jobs/{pipeline_run} 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://ffast.app/v1/jobs/PIPELINE_RUN \
  -H "X-API-Key: $FFAST_PIPELINE_KEY"

Le sondage de tâche commence par une attente initiale d'une seconde sur FFast. La vue suivante couvre le backoff limité.

Les erreurs prévisibles

FFast Il affiche un ID de demande de support à côté et ne masque pas la gestion prévisible du client.

{
  "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

FFast active les quotas mesurés qui maintiennent la transmission réactive sans placer de charge non sécurisée sur les plates-formes en amont.

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.

FFast aborde l'accès au schéma par le biais de l'activation avant l'exploration, puis l'authentification attribuée.

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

Activer par le biais du support

Fournissez à FFast un résumé concis du produit, une projection du trafic et une liste des plateformes. Indiquez si des vérifications des métadonnées, des travaux préparés ou les deux sont nécessaires afin que la clé émise corresponde au flux de travail réel.

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