Kun prøveversion — aktivering kræves

Byg downloads med downf.io

DownF holder API-udførelse deaktiveret, indtil en operatør gennemgår kompatibilitetsbrugstilfældet. Eksemplerne beskriver den planlagte kontrakt, mens rigtige legitimationsoplysninger og kvoter kun ankommer gennem supportaktivering.

DownfBridgeJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

DownF organiserer API-værten omkring supportaktiverede legitimationsoplysninger. Dens kompatibilitetsvisning sammenligner en tildelt lejer-endpoint. En server-only opkaldssti forbliver den endelige kontrol.

Lejer- URLhttps://downf.io

GodkendelseX-API-Key: pending_activation_…

Profil af klientDownfBridge

Version af APIv1

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

Sikkerhed for legitimationsoplysninger begynder med server-side hemmelig opbevaring på DownF. Denne kompatibilitetsvisning præsenterer derefter ingen klientpakkeindlejring. Det endelige faktum er ingen offentlige logfiler eller arkiver.

Løsning af et link

DownF organiserer Resolve-operationen omkring kildeidentifikation. Dens kompatibilitetsvisning sammenligner formater fra en indsendt URL. Ingen opfundne output forbliver den endelige kontrol.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrævet	Beskrivelse
`media_address`	HTTPS- URL	Ja	Offentlig eller autoriseret medieside at analysere.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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

Formatidentifikatoren begynder med den returnerede værdi uændret på DownF. Denne kompatibilitetsvisning præsenterer derefter tilgængelighed pr. link. Det endelige faktum er ingen gættet kvalitetsmærkat.

Opret og følg et downloadjob

Joboprettelse starter med asynkron forberedelse på DownF. Den næste visning dækker en kort HTTP-anmodning. Siden holder begrænset arbejderudførelse synlig.

POST/v1/jobsOmfang: job

Felt	Type	Påkrævet	Beskrivelse
`media_address`	HTTPS- URL	Ja	Den samme normaliserede kilde indsendt til at løse.
`output_ref`	streng	Ja	Et nøjagtigt id fra forklaringssvaret.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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 AccepteretGem transfer_ref.

2AfstemningsstatusGET /v1/jobs/{transfer_ref} med samme nøgle.

3KlarÅbn den signerede download-URL.

Status	Betydning	Klienthandling
`queued`	Optaget i den afgrænsede kø.	Afstemning igen med tilbageslag.
`extracting`	Opdatering af kildemetadata eller rute.	Fortsæt med at stemme.
`processing`	Downloading, remuxing eller sammenlægning.	Vis server fremskridt.
`ready`	Signeret download er tilgængelig.	Send URL-adressen til brugeren.
`failed`	Terminal struktureret fejl.	Læs `error_code`. Prøv kun igen, når det anbefales.
`expired`	Midlertidig output blev fjernet.	Opret et nyt job.

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

DownF's kompatibilitetsvisning gennemgår et initialt ventetid på et sekund for jobafstemning. Den viser begrænset tilbagefald næste gang og skjuler ikke midlertidig signeret levering.

Forudsigelige fejl

DownF præsenterer tre praktiske punkter for Fejlkontakt. Først kommer en ikke-2xx kuvert. Kompatibilitetsvisningen dækker derefter en supportanmodnings-ID. Det sidste punkt er forudsigelig 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 utilgængeligt format.	Ret anmodningen. Prøv igen for formater.
401	Manglende, ugyldig, udløbet eller forkert områdenøgle.	Kontroller legitimationsoplysningerne på serversiden.
403	Lejer- eller kildepolitikken afviste anmodningen.	Omgå ikke politikken. Kontakt support.
404	Ukendt eller udløbet job.	Opret eventuelt et nyt job.
429	Grænsen for anmodninger eller aktive job er nået.	Ære `retry_after_seconds`.
503	Kø/kapacitet eller opstrøm midlertidigt utilgængelig.	Prøv igen med eksponentiel tilbagefald og jitter.

Driftskontrakt

DownF tildeler en anmodningsgrænse efter at have gennemgået den tilsigtede klient, hvilket holder dens kompatibilitetskontroller og upstream-udbydere stabile.

Brug idempotent programlogik, og start aldrig dublerede job for det samme brugerklik.
Cache løse metadata kortvarigt, men altid behandle underskrevne download URL'er som udløber.
Brug begrænset eksponentiel tilbagetrækning med jitter for 429, 503 og genforsøgbare fejl.
Behandl kun offentlige medier eller medier, du har tilladelse til at få adgang til. DRM og adgangskontroller omgås ikke.
Behold anmodnings-ID'er og job-ID'er i private driftslogfiler. Log ikke indsendte URL'er unødvendigt.

DownF organiserer Schema-adgang omkring aktivering før udforskning. Dens kompatibilitetsvisning sammenligner tildelt autentificering. Dokumenterede anmodningsformer forbliver den endelige kontrol.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Beskriv produktet, forudsig dets månedlige opkald og list de platforme, det skal analysere. DownF support vil bekræfte de nødvendige scopes, før der udstedes en engangs synlig legitimationsoplysning, hvis gemte kopi kun er et hash.

Anmod om aktivering Nøgler er lejerafgrænsede, kan tilbagekaldes og udstedes via kontaktformularen. Anonyme scripts kan ikke udføre downloaderarbejde.