Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med downf.io

DownF håller API-körning inaktiverad tills en operatör granskar kompatibilitetsfallet. Exemplen beskriver det planerade kontraktet, medan riktiga autentiseringsuppgifter och kvoter endast kommer genom supportaktivering.

DownfBridgeJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

DownF organiserar API-värd runt stödaktiverade autentiseringsuppgifter. Dess kompatibilitetsvy jämför en tilldelad hyresgästandpunkt. En serverendast anropsväg förblir den slutgiltiga kontrollen.

Webbadress till klienthttps://downf.io

AutentiseringX-API-Key: pending_activation_…

KlientprofilDownfBridge

API-versionv1

# 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"}'

Säkerhet för autentiseringsuppgifter börjar med serverbaserad hemlig lagring på DownF. Denna kompatibilitetsvy visar sedan ingen klientpaket-inbäddning. Den slutgiltiga faktan är inga offentliga loggar eller arkiv.

Lösa en länk

DownF organiserar Resolve-operationen kring källupptäckt. Dess kompatibilitetsvy jämför format från en inskickad URL. Inga påhittade utdata förblir den slutgiltiga kontrollen.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`media_address`	HTTPS- URL	Ja	Offentlig eller auktoriserad mediesida att analysera.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Formatidentifieraren börjar med det returnerade värdet oförändrat på DownF. Denna kompatibilitetsvy visar sedan tillgänglighet per länk. Den slutgiltiga faktan är ingen gissad kvalitetsmärkning.

Skapa och följ ett nedladdningsjobb

Jobbskapande börjar med asynkron förberedelse på DownF. Nästa vy täcker en kort HTTP-förfrågan. Sidan håller begränsad arbetarexekvering synlig.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`media_address`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`output_ref`	sträng	Ja	Ett exakt ID från lösningssvaret.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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"}'

1202 GodkändSpara transfer_ref.

2OmröstningsstatusGET /v1/jobs/{transfer_ref} med samma nyckel.

3KlarÖppna den signerade nedladdnings-URL:en.

Status	Betydelse	Klientåtgärd
`queued`	Antagen till den begränsade kön.	Rösta igen med fördröjning.
`extracting`	Uppdaterar källmetadata eller rutt.	Fortsätt med omröstningen.
`processing`	Laddar ner, remuxar eller slår ihop.	Visa serverns framsteg.
`ready`	Signerad nedladdning är tillgänglig.	Skicka URL:en till användaren.
`failed`	Terminal strukturerat fel.	Läs `error_code`. Försök igen endast när det rekommenderas.
`expired`	Tillfällig utdata togs bort.	Skapa ett nytt jobb.

curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

DownF:s kompatibilitetsvy granskar en sekunds initial väntan för jobb-pollning. Den visar begränsad backoff nästa och döljer inte tillfällig signerad leverans.

Förutsägbara fel

DownF presenterar tre praktiska punkter för Felkontrakt. Först kommer ett icke-2xx-meddelande. Kompatibilitetsvyn omfattar sedan en supportförfrågnings-ID. Dess sista punkt är förutsägbar klienthantering.

{
  "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	Typisk betydelse	Åtgärd
400	Ogiltig URL, innehåll eller otillgängligt format.	Korrigera förfrågan. Lös igen för format.
401	Saknad, ogiltig, utgången eller felaktig nyckel med fel behörighet.	Kontrollera serverns autentiseringsuppgifter.
403	Hyresgäst- eller källpolicy avvisade förfrågan.	Bryt inte mot policyn. Kontakta support.
404	Okänt eller utgånget jobb.	Skapa ett nytt jobb om det är lämpligt.
429	Begäran eller aktivt jobbgräns uppnådd.	Heder `retry_after_seconds`.
503	Kö/kapacitet eller upstream tillfälligt otillgänglig.	Försök igen med exponentiell backoff och jitter.

Driftkontrakt

DownF tilldelar ett förfrågningsmaximum efter att ha granskat den avsedda klienten, och håller dess kompatibilitetskontroller och upstream-leverantörer stabila.

Använd idempotent programlogik och starta aldrig dubbla jobb för samma användarklick.
Cache lösa metadata kort, men alltid behandla signerade nedladdning webbadresser som löper ut.
Använd begränsad exponentiell backoff med jitter för 429, 503 och omförsökbara fel.
Bearbeta endast offentliga medier eller medier som du har behörighet att komma åt. DRM och åtkomstkontroller kringgås inte.
Spara begäran-ID och jobb-ID i privata driftloggar. Logga inte inskickade webbadresser i onödan.

DownF organiserar Schema-åtkomst kring aktivering före utforskning. Dess kompatibilitetsvy jämför tilldelad autentisering. Dokumenterade förfrågningsformat förblir den slutgiltiga kontrollen.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Beskriv produkten, prognostisera dess månatliga samtal och lista de plattformar den måste analysera. DownF-supporten kommer att bekräfta de nödvändiga behörigheterna innan en engångs synlig referens utfärdas vars lagrade kopia endast är en hash.

Begär aktivering av konto Nycklar är klientomfattande, återkalleliga och utfärdas via Kontaktformuläret. Anonyma skript kan inte utföra hämtningsarbete.