https://easyf.appBouw downloads met EasyF
EasyF toont de interface vooraf zodat ontwikkelaars hun werk kunnen inschatten. Een ondersteuningsbeoordeling is nog steeds vereist voordat een live sleutel en gebruiksgrens bestaan.
EasyfClientVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik
01
Snel aan de slag
Om de API-host uit te leggen, scheidt EasyF door support geactiveerde referenties van een toegewezen tenant-eindpunt. Een workflow in gewone taal geeft een server-only oproeppad een eigen plaats.
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"}'Credential safety begint met server-side geheime opslag op EasyF. De volgende weergave behandelt het niet insluiten van client-bundels. De pagina houdt geen openbare logs of zichtbare repositories bij.
02
Een koppeling oplossen
Om de werking van Resolve uit te leggen, scheidt EasyF bronherkenning van formaten van één ingediende URL. Een workflow in gewone taal geeft geen verzonnen outputs een eigen plaats.
POST
/v1/resolveToepassingsgebied: oplossen| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
asset_url | HTTPS-URL | Ja. | Openbare of geautoriseerde mediapagina om te analyseren. |
tenant | tekenreeks | Nee. | Toegewezen tenantdomein. Meestal weggelaten. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Formaatidentificatie begint met de ongewijzigde geretourneerde waarde op EasyF. De volgende weergave behandelt beschikbaarheid per link. De pagina toont geen geraden kwaliteitslabel.
03
Maak en volg een downloadtaak
EasyF presenteert drie praktische punten voor het aanmaken van een Taak. Eerst komt asynchrone voorbereiding. De workflow in gewone taal behandelt vervolgens een korte HTTP-aanvraag. Het laatste punt is begrensde uitvoering door de worker.
POST
/v1/jobsScope: vacatures| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
asset_url | HTTPS-URL | Ja. | Dezelfde genormaliseerde bron ingediend om op te lossen. |
variant_code | tekenreeks | Ja. | Een exacte ID uit de resolve-respons. |
tenant | tekenreeks | Nee. | Toegewezen tenantdomein. Meestal weggelaten. |
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} met dezelfde sleutel.| Status | Betekenis | Actie van de klant |
|---|---|---|
queued | Toegestaan in de beperkte wachtrij. | Poll weer met achteruit. |
extracting | Bronmetadata of route vernieuwen. | Ga door met pollen. |
processing | Bezig met downloaden, remuxen of samenvoegen. | Toon server voortgang. |
ready | Ondertekende download is beschikbaar. | Stuur de URL naar de gebruiker. |
failed | Terminal gestructureerde fout. | Lees error_codeProbeer het alleen opnieuw als dat wordt geadviseerd. |
expired | Tijdelijke uitvoer werd verwijderd. | Maak een nieuwe taak aan. |
curl https://easyf.app/v1/jobs/DELIVERY_ID \
-H "X-API-Key: $EASYF_SERVICE_KEY"EasyF benadert Job polling via een initiële wachttijd van één seconde, gevolgd door een begrensde backoff. De eenvoudige workflow houdt tijdelijke ondertekende levering expliciet.
04
Voorspelbare fouten
EasyF organiseert de Foutcontract rond één niet-2xx envelop. De workflow in gewone taal vergelijkt een supportverzoek-ID. Voorspelbare clientafhandeling blijft de laatste controle.
{
"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 | Typische betekenis | Actie |
|---|---|---|
| 400 | Ongeldige URL, body of niet beschikbare indeling. | Corrigeer de aanvraag. Los opnieuw op voor formaten. |
| 401 | Ontbrekende, ongeldige, verlopen of verkeerd bereik sleutel. | Controleer de serverzijde referentie. |
| 403 | Tenant of bronbeleid heeft de aanvraag afgewezen. | Omzeil het beleid niet. Neem contact op met de ondersteuning. |
| 404 | Onbekende of verlopen vacature. | Maak indien nodig een nieuwe taak aan. |
| 429 | Aanvraag- of actieve-taaklimiet bereikt. | Eer retry_after_seconds. |
| 503 | Wachtrij/capaciteit of upstream tijdelijk niet beschikbaar. | Probeer het opnieuw met exponentiële backoff en jitter. |
05
Operationeel contract
EasyF stemt praktische gebruiksgrenzen af met elk goedgekeurd product om een voorspelbare begeleide workflow te behouden.
- Gebruik idempotente toepassingslogica en start nooit dubbele taken voor dezelfde gebruikersklik.
- Cache lost metadata kort op, maar behandelt ondertekende download-URL's altijd als verlopen.
- Gebruik begrensde exponentiële backoff met jitter voor
429,503en herprobeerbare fouten. - Verwerk alleen openbare media of media waarvoor u toegangsrechten hebt, en vermijd het omzeilen van DRM en toegangscontrole.
- Bewaar verzoek-ID's en taak-ID's in privé-operationele logboeken. Log niet onnodig verzonden URL's.
Om Schema-toegang uit te leggen, scheidt EasyF activatie vóór verkenning van toegewezen authenticatie. Een workflow in gewone taal geeft gedocumenteerde aanvraagvormen een eigen plek.
Activeren via ondersteuning
Vertel EasyF wat je bouwt, hoe vaak het de API zal aanroepen en welke providers belangrijk zijn. De beoordeling bepaalt de toegestane bewerkingen en onthult vervolgens één keer een referentie terwijl alleen de veilige digest wordt opgeslagen.
Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.