Aperçu seulement — activation requise

Téléchargements de construction avec EasyT

Cette référence EasyT est un guide d'implémentation plutôt qu'un point de terminaison anonyme actif. L'accès en production commence uniquement après que le support a approuvé le client et attribué des limites.

EasytWorkspaceJSON sur HTTPSTravaux asynchronesScoped credentials

Démarrage rapide

L'hôte API commence avec des informations d'identification activées par le support sur EasyT. Cette vérification guidée présente ensuite un point de terminaison de locataire affecté.

URL du locatairehttps://easyt.io

AuthentificationX-API-Key: pending_activation_…

Profil du clientEasytWorkspace

Version de l'APIv1

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

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

Dans EasyT, le stockage secret côté serveur est prioritaire lors de l'explication de la sécurité des identifiants. Cette vérification guidée suit sans intégration de bundle client et se termine sans journaux publics ni dépôts.

Résoudre un lien

L'opération de résolution commence par la détection de la source sur EasyT. Cette vérification guidée présente ensuite les formats à partir d'une URL soumise.

POST/v1/resolvePortée: résoudre

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

Dans EasyT, la valeur retournée inchangée vient en premier lors de l'explication de l'identifiant de format. Cette vérification guidée suit avec la disponibilité par lien et se ferme sur aucune étiquette de qualité deviné.

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

La préparation asynchrone est le point de départ de la création de tâches sur EasyT. Une vérification guidée présente ensuite une courte requête HTTP et explique l'exécution de worker limité.

POST/v1/jobsPortée: emplois

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

1202 AcceptéesEnregistrer workspace_job.

2État du sondageGET /v1/jobs/{workspace_job} 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://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

Pour le sondage de tâche, EasyT commence par une attente initiale d'une seconde. Sa vérification guidée l'appaire avec un backoff plafonné et se termine par une livraison temporaire signée.

Les erreurs prévisibles

EasyT La page commence par une enveloppe non 2xx, passe à un ID de demande d'assistance et indique clairement 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

EasyT sélectionne une allocation d'exploitation pendant l'examen, en équilibrant les besoins de l'application avec la santé du fournisseur.

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.

L'accès au schéma commence par l'activation avant l'exploration sur EasyT. Cette vérification guidée présente ensuite l'authentification attribuée.

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

Activer par le biais du support

Incluez l'objectif client, la charge de travail mensuelle prévue et les réseaux demandés dans la note d'activation. EasyT peut alors choisir de résoudre et de définir correctement les périmètres de travail avant de produire un secret à vue unique.

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