https://easyf.appCostruire i download con EasyF
EasyF mostra l'interfaccia in anticipo in modo che gli sviluppatori possano stimare il loro lavoro. È ancora necessaria una revisione del supporto prima che esistano una chiave live e un limite di utilizzo.
EasyfClientJSON su HTTPSLavori asincroniCredenziali con ambito
01
Quick start
Per spiegare l'host API, EasyF separa le credenziali attivate dal supporto da un endpoint tenant assegnato. Un flusso di lavoro in linguaggio semplice assegna un percorso di chiamata solo server al proprio posto.
X-API-Key: pending_activation_…EasyfClientv1# 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 sicurezza delle credenziali inizia con l'archiviazione segreta lato server su EasyF. La vista successiva copre nessun embedding di bundle client. La pagina non mantiene log pubblici o repository visibili.
02
Risolvere un collegamento
Per spiegare l'operazione Resolve, EasyF separa il rilevamento della fonte dai formati da un URL inviato. Un flusso di lavoro in linguaggio semplice non assegna un posto a output inventati.
POST
/v1/resolveAmbito di applicazione: risolvere| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
asset_url | URL HTTPS | Sì | Pagina media pubblica o autorizzata da analizzare. |
tenant | stringa | No. | Dominio tenant assegnato. In genere omesso. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}L'identificatore del formato inizia con il valore restituito invariato su EasyF. La vista successiva copre la disponibilità per collegamento. La pagina non mantiene alcuna etichetta di qualità ipotizzata visibile.
03
Creare e seguire un processo di download
EasyF presenta tre punti pratici per la creazione di un Job. Il primo è la preparazione asincrona, il flusso di lavoro in linguaggio semplice copre quindi una breve richiesta HTTP e il punto finale è l'esecuzione del worker limitato.
POST
/v1/jobsAmbito: posti di lavoro| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
asset_url | URL HTTPS | Sì | La stessa fonte normalizzata è stata inviata per la risoluzione. |
variant_code | stringa | Sì | Un ID esatto dalla risposta di risoluzione. |
tenant | stringa | No. | Dominio tenant assegnato. In genere omesso. |
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"}'delivery_id.GET /v1/jobs/{delivery_id} con la stessa chiave.| Stato | Significato | Azione del cliente |
|---|---|---|
queued | Ammesso alla coda limitata. | Sondaggio di nuovo con backoff. |
extracting | Aggiornamento dei metadati di origine o della rotta. | Continua a sondare. |
processing | Scaricare, remux o unire. | Visualizza il progresso del server. |
ready | Il download firmato è disponibile. | Invia l'URL all'utente. |
failed | Errore strutturato terminale. | Leggi error_codeRiprova solo quando ti viene consigliato. |
expired | L'uscita temporanea è stata rimossa. | Creare un nuovo lavoro. |
curl https://easyf.app/v1/jobs/DELIVERY_ID \
-H "X-API-Key: $EASYF_SERVICE_KEY"EasyF affronta il polling del lavoro con un'attesa iniziale di un secondo, poi un backoff limitato. Il flusso di lavoro in linguaggio semplice mantiene esplicita la consegna temporanea firmata.
04
Errori prevedibili
EasyF organizza il contratto di errore attorno a un unico involucro non 2xx. Il suo flusso di lavoro in linguaggio semplice confronta un ID di richiesta di supporto. La gestione prevedibile del client rimane il controllo 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 | Significato tipico | Azione |
|---|---|---|
| 400 | URL, corpo o formato non valido. | Correggi la richiesta. Risolvi di nuovo per i formati. |
| 401 | Chiave mancante, non valida, scaduta o con ambito errato. | Verificare le credenziali lato server. |
| 403 | Criterio di tenant o di origine ha rifiutato la richiesta. | Non aggirare la politica. Contattare l'assistenza. |
| 404 | Offerta di lavoro sconosciuta o scaduta. | Creare un nuovo lavoro, se del caso. |
| 429 | Richiesta o limite di lavori attivi raggiunto. | Onore retry_after_seconds. |
| 503 | Coda/capacità o upstream temporaneamente non disponibile. | Riprova con backoff esponenziale e jitter. |
05
Contratto operativo
EasyF concorda limiti pratici d'uso con ogni prodotto approvato per preservare un flusso di lavoro guidato e prevedibile.
- Usa una logica applicativa idempotente e non avviare mai lavori duplicati per lo stesso clic dell'utente.
- Memorizza brevemente i metadati di risoluzione, ma considera sempre le URL di download firmate come scadute.
- Usa il backoff esponenziale limitato con jitter per
429,503e errori riprovabili. - Elabora solo media pubblici o media a cui sei autorizzato ad accedere. DRM e controlli di accesso non vengono bypassati.
- Conserva gli ID delle richieste e gli ID dei lavori nei registri operativi privati. Non registrare inutilmente gli URL inviati.
Per spiegare l'accesso allo Schema, EasyF separa l'attivazione prima dell'esplorazione dall'autenticazione assegnata. Un flusso di lavoro in linguaggio semplice assegna alle forme di richiesta documentate un proprio spazio.
Attivazione tramite supporto
Indica a EasyF cosa stai costruendo, con quale frequenza chiamerà l'API e quali provider sono importanti. La revisione decide le operazioni consentite, quindi rivela una credenziale una volta salvando solo il suo digest sicuro.
Richiedi attivazione Le chiavi sono limitate all'inquilino, revocabili e rilasciate tramite il modulo di contatto. Gli script anonimi non possono eseguire lavori di download.