Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med downf.io

DownF holder API-kjøring deaktivert inntil en operatør vurderer kompatibilitetsbruken. Eksemplene beskriver den planlagte kontrakten, mens ekte legitimasjon og kvoter kun kommer gjennom støtteaktivering.

DownfBridgeJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

DownF organiserer API-vert rundt støtte-aktiverte legitimasjoner. Dens kompatibilitetsvisning sammenligner en tildelt leietakerendepunkt. En serverkun kallsti forblir den endelige sjekken.

Leietaker-URLhttps://downf.io

AutentiseringX-API-Key: pending_activation_…

KlientprofilDownfBridge

API-versjonv1

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

Sikkerhet for legitimasjon begynner med server-side hemmelig lagring på DownF. Denne kompatibilitetsvisningen presenterer deretter ingen klientpakke-innbygging. Det endelige faktum er ingen offentlige logger eller arkiver.

Løse en kobling

DownF organiserer Resolve-operasjonen rundt kildeoppdagelse. Dens kompatibilitetsvisning sammenligner formater fra en innsendt URL. Ingen oppdiktede utdata forblir den endelige sjekken.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrevd	Beskrivelse
`media_address`	HTTPS-URL	Ja	Offentlig eller autorisert medieside å analysere.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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

Formatidentifikatoren begynner med den returnerte verdien uendret på DownF. Denne kompatibilitetsvisningen viser deretter tilgjengelighet per lenke. Det endelige faktum er ingen gjettet kvalitetsmerkelapp.

Opprett og følg en nedlastingsjobb

Jobb opprettelse starter med asynkron forberedelse på DownF. Neste visning dekker en kort HTTP-forespørsel. Siden holder begrenset arbeidstaker utførelse synlig.

POST/v1/jobsOmfang: jobber

Felt	Type	Påkrevd	Beskrivelse
`media_address`	HTTPS-URL	Ja	Den samme normaliserte kilden innlevert for å løse.
`output_ref`	streng	Ja	En nøyaktig ID fra løsningssvaret.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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 AkseptertLagre@ action: button transfer_ref.

2AvstemningsstatusGET /v1/jobs/{transfer_ref} med samme nøkkel.

3KlarÅpne den signerte nedlastingsadressen.

Status	Betydning	Klienthandling
`queued`	Opptatt i den begrensede køen.	Avstemning igjen med baklengs.
`extracting`	Oppdaterer kildemetadata eller rute.	Fortsett å avstemme.
`processing`	Laster ned, remikser eller slår sammen.	Vis server fremgang.
`ready`	Signert nedlasting er tilgjengelig.	Send URL-adressen til brukeren.
`failed`	Terminalstrukturert feil.	Lest `error_code`Prøv på nytt bare når det anbefales.
`expired`	Midlertidig utgang ble fjernet.	Opprett en ny jobb.

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

DownF sin kompatibilitetsvisning vurderer ett sekunds initial ventetid for jobbspørring. Den viser begrenset tilbakekobling neste og skjuler ikke midlertidig signert levering.

Forutsigbare feil

DownF presenterer tre praktiske punkter for Feilkontrakt. Først kommer en ikke-2xx konvolutt. Kompatibilitetsvisningen dekker deretter en støtteforespørsels-ID. Det siste punktet er forutsigbar klienthåndtering.

{
  "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 betydning	Handling
400	Ugyldig URL, brødtekst eller utilgjengelig format.	Rett opp forespørselen. Løs igjen for formater.
401	Manglende, ugyldig, utløpt eller feil omfang nøkkel.	Sjekk server-side legitimasjon.
403	Leietaker eller kildepolicy avslo forespørselen.	Ikke omgå policyen. Kontakt kundestøtte.
404	Ukjent eller utløpt jobb.	Opprett en ny jobb om det er passende.
429	Grensen for forespørsler eller aktive jobber er nådd.	Ære `retry_after_seconds`.
503	Kø/kapasitet eller oppstrøms midlertidig utilgjengelig.	Prøv igjen med eksponentiell tilbakeslag og jitter.

Driftskontrakt

DownF tildeler et forespørselstak etter å ha gjennomgått den tiltenkte klienten, og holder sine kompatibilitetskontroller og oppstrømsleverandører stabile.

Bruk idempotent programlogikk og aldri starte dupliserte jobber for samme bruker klikk.
Cache løse metadata kort, men alltid behandle signerte nedlastingsadresser som utløper.
Bruk begrenset eksponentiell tilbakeslag med jitter for 429, 503 og gjentatte feil.
Behandle bare offentlige medier eller medier du har autorisert tilgang til. DRM og tilgangskontroller omgås ikke.
Oppbevar forespørsels-ID-er og jobb-ID-er i private driftslogger. Ikke logg innsendte URL-er unødvendig.

DownF organiserer Schema-tilgang rundt aktivering før utforskning. Dens kompatibilitetsvisning sammenligner tildelt autentisering. Dokumenterte forespørselsformer forblir den endelige sjekken.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Beskriv produktet, prognostiser dets månedlige anrop og list opp plattformene det må analysere. DownF-støtte vil bekrefte de nødvendige omfangene før de utsteder en engangs synlig legitimasjon hvis lagrede kopi kun er en hash.

Be om aktivering Nøklene er basert på leietakers omfang, kan tilbakekalles og utstedes via Kontaktskjemaet.