Samo pregled – potrebna je aktivacija

Izgradite preuzimanja s downf.io

DownF drži izvršavanje API-ja onemogućeno dok operater ne pregleda slučaj uporabe kompatibilnosti. Primjeri opisuju planirani ugovor, dok stvarne vjerodajnice i kvote stižu samo putem aktivacije podrške.

DownfBridgeJSON preko HTTPS-aAsinkroni posloviVjerodajnice s opsegom

Brzi početak rada

DownF organizira API host oko podrške aktiviranih vjerodajnica. Njegov prikaz kompatibilnosti uspoređuje dodijeljenu krajnju točku zakupca. Put poziva samo na poslužitelju ostaje završna provjera.

URL klijentahttps://downf.io

AutentifikacijaX-API-Key: pending_activation_…

Profil klijentaDownfBridge

Verzija API-jav1

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

Sigurnost vjerodajnica započinje tajnim spremištem na strani poslužitelja na DownF-u. Ovaj prikaz kompatibilnosti zatim ne predstavlja ugradnju klijentskog paketa. Završna činjenica je da nema javnih zapisnika ili repozitorija.

Rješavanje veze

DownF organizira operaciju Resolve oko otkrivanja izvora. Njegov prikaz kompatibilnosti uspoređuje formate iz jednog poslanog URL-a. Neizmišljeni izlazi ostaju konačna provjera.

POST/v1/resolveOpseg: riješiti

Polje	Tip	Obvezno	Opis
`media_address`	HTTPS URL	Da	Javna ili ovlaštena medijska stranica za analizu.
`tenant`	string	-Ne. -Ne?	Dodijeljena domena klijenta. Obično se izostavlja.

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

Identifikator formata počinje s vraćenom vrijednošću nepromijenjenom na DownF. Taj prikaz kompatibilnosti zatim prikazuje dostupnost po poveznici. Konačna činjenica je da nema pretpostavljene oznake kvalitete.

Stvaranje i praćenje zadatka preuzimanja

Stvaranje posla počinje s asinkronskom pripremom na DownF. Sljedeći pogled pokriva kratki HTTP zahtjev. Stranica drži vidljivo izvršenje ograničenog radnika.

POST/v1/jobsPodručje primjene: poslovi

Polje	Tip	Obvezno	Opis
`media_address`	HTTPS URL	Da	Isti normalizirani izvor predan za rješavanje.
`output_ref`	string	Da	Točan ID iz odgovora na rješavanje.
`tenant`	string	-Ne. -Ne?	Dodijeljena domena klijenta. Obično se izostavlja.

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 PrihvaćenoSpremi transfer_ref.

2Status anketeGET /v1/jobs/{transfer_ref} istim ključem.

3SpremniOtvorite potpisani URL za preuzimanje.

Status	Značenje	Akcija klijenta
`queued`	Prihvaćeno u ograničeni red.	Ponovno anketiranje s odmakom.
`extracting`	Osvježavanje izvornih metapodataka ili rute.	Nastavite s glasovanjem.
`processing`	Preuzimanje, remiksanje ili spajanje.	Prikaz napretka poslužitelja.
`ready`	Potpisano preuzimanje je dostupno.	Pošaljite URL korisniku.
`failed`	Terminal strukturirana pogreška.	Pročitajte `error_code`. Ponovite samo kada se savjetuje.
`expired`	Privremeni izlaz je uklonjen.	Stvorite novi posao.

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

DownF-ov pregled kompatibilnosti pregledava jedno sekundno početno čekanje za anketiranje poslova. Prikazuje ograničeni backoff sljedeći i ne zasjeni privremenu potpisanu isporuku.

Predvidljive pogreške

DownF predstavlja tri praktične točke za Error ugovor. Prva je jedan ne-2xx omotač. Kompatibilni prikaz zatim obuhvaća ID zahtjeva za podršku. Njegova završna točka je predvidljivo rukovanje na strani klijenta.

{
  "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	Tipično značenje	Akcija
400	Nevažeći URL, tijelo ili nedostupan format.	Ispravite zahtjev. Resolvirajte ponovno za formate.
401	Ključ nedostaje, nije valjan, istekao je ili ima pogrešan opseg.	Provjerite vjerodajnice na strani poslužitelja.
403	Zahtjev je odbio stanar ili izvorno pravilo.	Nemojte zaobići pravilnik. Kontaktirajte podršku.
404	Nepoznat ili istekao posao.	Stvorite novi posao ako je to prikladno.
429	Dostignuto je ograničenje zahtjeva ili aktivnih zadataka.	Čast `retry_after_seconds`.
503	Red čekanja/kapaciteta ili upstream privremeno nedostupan.	Pokušajte ponovno s eksponencijalnim backoff i jitter.

Ugovor o radu

DownF dodjeljuje strop zahtjeva nakon pregleda namjeravanog klijenta, održavajući svoje provjere kompatibilnosti i pružatelje usluga u uzlaznoj liniji stabilnima.

Koristite idempotentnu logiku aplikacije i nikada ne pokrenite duplicirane poslove za isti klik korisnika.
Predmemorija rješava metapodatke kratko, ali uvijek tretira potpisane URL-ove za preuzimanje kao isteka.
Koristite ograničeni eksponencijalni backoff s jitterom za 429, 503 i ponovljive pogreške.
Obrađujte samo javne medije ili medije za koje imate ovlaštenje pristupa. DRM i kontrole pristupa nisu zaobiđene.
ID-ove zahtjeva i ID-ove poslova čuvajte u privatnim operativnim zapisnicima. Nemojte nepotrebno bilježiti poslane URL-ove.

DownF organizira pristup Schemi oko aktivacije prije istraživanja. Njegov prikaz kompatibilnosti uspoređuje dodijeljenu autentifikaciju. Dokumentirane oblike zahtjeva ostaju završna provjera.

PRISTUP KOJI PREGLEDA OPERATER

Aktivirajte se putem podrške

Opišite proizvod, predvidite njegov mjesečni broj poziva i navedite platforme koje mora analizirati. Podrška DownF potvrdit će potrebne opsege prije izdavanja jednokratne vidljive vjerodajnice čija je pohranjena kopija samo hash.

Zatražite aktivaciju Ključevi su ograničeni na zakupca, opozivi su mogući i izdaju se putem obrasca za kontakt. Anonimni skripti ne mogu izvršavati preuzimanje radova.