https://downf.ioBouw downloads met downf.io
DownF houdt de API-uitvoering uitgeschakeld totdat een operator de compatibiliteitsgebruikszaak beoordeelt. De voorbeelden beschrijven het geplande contract, terwijl echte referenties en quota alleen via ondersteuning worden geactiveerd.
DownfBridgeVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik
01
Snel aan de slag
DownF organiseert de API-host rond door ondersteuning geactiveerde referenties. De compatibiliteitsweergave vergelijkt een toegewezen tenant-eindpunt. Een server-only oproeppad blijft de laatste controle.
X-API-Key: pending_activation_…DownfBridgev1# Available only after support activation
export DOWNF_ACCESS_TOKEN="issued-after-review"
curl -X POST https://downf.io/v1/resolve \
-H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID"}'De veiligheid van referenties begint met server-side geheime opslag op DownF. Deze compatibiliteitsweergave toont vervolgens geen client-bundel insluiting. Het laatste feit is dat er geen openbare logs of repositories zijn.
02
Een koppeling oplossen
DownF organiseert Resolve-operaties rond bronherkenning. De compatibiliteitsweergave vergelijkt formaten van één ingediende URL. Geen verzonnen uitvoer blijft de laatste controle.
POST
/v1/resolveToepassingsgebied: oplossen| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
media_address | 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
}Het formaatidentificatie begint met de ongewijzigde geretourneerde waarde op DownF. Deze compatibiliteitsweergave toont vervolgens beschikbaarheid per link. Het laatste feit is dat er geen geraden kwaliteitslabel is.
03
Maak en volg een downloadtaak
Het maken van de taak begint met een asynchrone voorbereiding op DownF. De volgende weergave behandelt een korte HTTP-aanvraag.
POST
/v1/jobsScope: vacatures| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
media_address | HTTPS-URL | Ja. | Dezelfde genormaliseerde bron ingediend om op te lossen. |
output_ref | tekenreeks | Ja. | Een exacte ID uit de resolve-respons. |
tenant | tekenreeks | Nee. | Toegewezen tenantdomein. Meestal weggelaten. |
curl -X POST https://downf.io/v1/jobs \
-H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'transfer_ref.GET /v1/jobs/{transfer_ref} 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://downf.io/v1/jobs/TRANSFER_REF \
-H "X-API-Key: $DOWNF_ACCESS_TOKEN"Het toont een afgekapte backoff naast en verbergt geen tijdelijke ondertekende levering. Het toont afgekapte backoff volgende en verduistert niet tijdelijke ondertekende levering.
04
Voorspelbare fouten
DownF presenteert drie praktische punten voor de Foutcontract. Eerst komt een niet-2xx envelop. De compatibiliteitsweergave behandelt vervolgens een ondersteuningsverzoek-ID. Het laatste punt is voorspelbare clientafhandeling.
{
"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
DownF wijst een verzoekplafond toe na het beoordelen van de beoogde client, waarbij de compatibiliteitscontroles en stroomopwaartse providers stabiel blijven.
- 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.
DownF organiseert Schema-toegang rond activatie vóór verkenning. De compatibiliteitsweergave vergelijkt toegewezen authenticatie. Gedocumenteerde aanvraagvormen blijven de laatste controle.
Activeren via ondersteuning
Beschrijf het product, voorspel het aantal maandelijkse oproepen en lijst de platforms op die geanalyseerd moeten worden. De ondersteuning van DownF zal de vereiste reikwijdtes bevestigen voordat een eenmalige zichtbare referentie wordt uitgegeven waarvan de opgeslagen kopie slechts een hash is.
Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.