Ainult eelvaade – nõutav aktiveerimine

Ehitage allalaadimised koos downf.io-ga

DownF hoiab API täitmise keelatuna, kuni operaator vaatab ühilduvuse kasutusjuhtumi läbi. Näited kirjeldavad kavandatud lepingut, samal ajal kui tegelikud volikirjad ja kvoodid saabuvad alles toe aktiveerimise kaudu.

DownfBridgeJSON HTTPS-i kauduAsünkroonsed töökohadKohaldamisalaga identimisteave

Kiire algus

DownF korraldab API hosti tugiga aktiveeritud volituste ümber. Selle ühilduvusvaade võrdleb määratud rentniku lõpp-punkti. Ainult serveripoolne kõnetee jääb lõplikuks kontrolliks.

Rentniku URLhttps://downf.io

AutentimineX-API-Key: pending_activation_…

Kliendi profiilDownfBridge

API versioonv1

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

Puutumisohutus algab serveripoolsest saladuste salvestamisest DownF-is. See ühilduvusvaade ei paku seejärel kliendipaketi manustamist. Lõppjäreldus on, et puuduvad avalikud logid või repositooriumid.

Lingi lahendamine

DownF korraldab Resolve'i toimingu lähtetuvastuse ümber. Selle ühilduvusvaade võrdleb ühest esitatud URL-ist pärinevaid vorminguid. Leiutatud väljundeid ei ole; lõplikuks kontrolliks jääb alles see.

POST/v1/resolveReguleerimisala: lahendada

Väli	Tüüp	Nõutav	Kirjeldus
`media_address`	HTTPS URL	Jah	Avalik või volitatud meedia leht analüüsimiseks.
`tenant`	string	Ei	Määratud rentniku domeen. Tavaliselt jäetakse välja.

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

Vormingu identifikaator algab tagastatud väärtusega muutmata kujul saidil DownF. See ühilduvusvaade esitab seejärel iga lingi saadavuse. Lõplik fakt on see, et kvaliteedimärgendit ei oletata.

Allalaadimistöö loomine ja jälgimine

Töö loomine algab asünkroonse ettevalmistusega DownF-is. Järgmine vaade käsitleb lühikest HTTP-päringut. Leht hoiab piiratud töölõime täitmise nähtavana.

POST/v1/jobsReguleerimisala: töökohad

Väli	Tüüp	Nõutav	Kirjeldus
`media_address`	HTTPS URL	Jah	Sama normaliseeritud allikas esitati lahendamiseks.
`output_ref`	string	Jah	Täpne ID lahendamisvastusest.
`tenant`	string	Ei	Määratud rentniku domeen. Tavaliselt jäetakse välja.

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

2Küsitluse staatusGET /v1/jobs/{transfer_ref} sama võtmega.

3ValmisAvage allkirjastatud allalaadimise URL.

Olek	Tähendus	Kliendi tegevus
`queued`	Lubatud piiratud järjekorda.	Küsitlus uuesti tagasilöögiga.
`extracting`	Värskendatakse lähtemetaadata või marsruuti.	Jätkake küsitlemist.
`processing`	Allalaadimine, remuxing või ühendamine.	Kuva serveri edenemine.
`ready`	Allkirjastatud allalaadimine on saadaval.	Saada URL kasutajale.
`failed`	Terminali struktureeritud viga.	Loe `error_code`Proovige uuesti ainult siis, kui seda soovitatakse.
`expired`	Ajutine väljund eemaldati.	Looge uus töökoht.

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

DownF-i ühilduvusvaade vaatab üle Job-i päringu ühe sekundi pikkuse algse ootamise. See näitab järgmise sammuna piiratud tagasiastet ega varja ajutist allkirjastatud edastust.

Eeldatavad vead

DownF esitleb kolm praktilist punkti Error contracti kohta. Esimesena tuleb üks mitte-2xx ümbrik. Ühilduvusvaade katab seejärel tugitaotluse ID. Selle viimane punkt on ennustatav kliendikäsitlus.

{
  "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	Tüüpiline tähendus	Tegevus
400	Vigane URL, keha või kättesaamatu vorming.	Parandage taotlus. Lahendage uuesti vormingute jaoks.
401	Puuduv, kehtetu, aegunud või vale ulatusega võti.	Kontrollige serveripoolset mandaati.
403	Üürnik või allikapoliitika lükkas taotluse tagasi.	Ärge mööduge poliitikast. Võtke ühendust toega.
404	Tundmatu või aegunud töö.	Looge vajadusel uus töökoht.
429	Taotluste või aktiivsete tööde piirmäär on saavutatud.	Au. `retry_after_seconds`.
503	Järjekord/mahutavus või ülesvoolu ajutiselt kättesaamatu.	Proovige uuesti eksponentsiaalse tagasilöögi ja värisemisega.

Tegevusleping

DownF määrab päringupiiri pärast kavandatud kliendi ülevaatamist, hoides selle ühilduvuskontrollid ja ülesvoolu teenusepakkujad stabiilsena.

Kasutage idempotentset rakendusloogikat ja ärge kunagi käivitage sama kasutaja kliki jaoks duplikaattöid.
Puhverda lahendamise metaandmeid lühidalt, kuid käsitle allkirjastatud allalaadimise URL-e alati kui aeguvat.
Kasutage piiratud eksponentsiaalset tagasilööki koos värisemisega 429, 503 ja korratavaid vigu.
Töötle ainult avalikku meediat või meediat, millele sul on lubatud juurde pääseda. DRM- ja juurdepääsukontrolle ei mööda.
Hoidke päringute ID-d ja tööde ID-d privaatses operatiivlogides. Ärge logige esitatud URL-e tarbetult.

DownF korraldab Schema juurdepääsu aktiveerimise ümber enne uurimist. Selle ühilduvuse vaade võrdleb määratud autentimist. Dokumenteeritud päringu kujundid jäävad lõplikuks kontrolliks.

ETTEVÕTJA LÄBIVAATAMINE

Aktiveerimine tugiteenuse kaudu

Kirjeldage toodet, prognoosige selle igakuiseid kõnesid ja loetlege platvormid, mida see peab analüüsima. DownF-i tugi kinnitab vajalikud õigused enne ühekordse nähtava mandaadi väljastamist, mille salvestatud koopia on vaid räsi.

Taotle aktiveerimist Võtmed on üürniku ulatuses, tühistatavad ja väljastatakse kontaktivormi kaudu. Anonüümsed skriptid ei saa alla laadija tööd käivitada.