https://downf.ioRakenna lataukset downf.io: llä
DownF pitää API-suorituksen poissa käytöstä, kunnes operaattori arvioi yhteensopivuuskäyttötapauksen. Esimerkit kuvaavat suunniteltua sopimusta, kun taas oikeat tunnistetiedot ja kiintiöt tulevat vasta tuen aktivoinnin kautta.
DownfBridgeJSON HTTPS:n kauttaAsynkroniset työtLaajennetut tunnistetiedot
01
Pika-aloitus
DownF järjestää API-isännän tukiaktivoitujen tunnistetietojen ympärille. Sen yhteensopivuusnäkymä vertaa määritettyä tenantin päätepistettä. Vain palvelimelle tarkoitettu kutsupolku jää viimeiseksi tarkistukseksi.
X-API-Key: pending_activation_…DownfBridgev1# 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"}'Tunnistetietojen turvallisuus alkaa palvelinpuolen salaisesta tallennuksesta DownF:ssä. Tämä yhteensopivuusnäkymä ei siis esitä asiakaspuolen paketin upotusta. Lopullinen tosiasia on, ettei ole julkisia lokeja tai repositorioita.
02
Linkin ratkaiseminen
DownF järjestää Resolve-toiminnon lähdetunnistuksen ympärille. Sen yhteensopivuusnäkymä vertailee yhden lähetetyn URL-osoitteen formaatteja. Ei keksittyjä ulostuloja jää lopulliseksi tarkistukseksi.
POSTI
/v1/resolveLaajuus: ratkaista| Kenttä | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
media_address | HTTPS- URL | - Kyllä. | Julkinen tai valtuutettu mediapohja analysoitavaksi. |
tenant | merkkijono | Ei | Määrätty vuokralaisalue. Yleensä jätetään pois. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Muotoilutunniste alkaa palautetulla arvolla muuttumattomana DownF:ssä. Tämä yhteensopivuusnäkymä esittää sitten linkkikohtaisen saatavuuden. Lopullinen fakta on, ettei ole arvuuteltua laatumerkintää.
03
Luo ja seuraa lataustehtävää
Työn luominen alkaa asynkronisella valmistelulla DownF:ssä. Seuraava näkymä kattaa lyhyen HTTP-pyynnön. Sivu pitää rajatun työntekijäsuorituksen näkyvissä.
POSTI
/v1/jobsLaajuus: työpaikat| Kenttä | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
media_address | HTTPS- URL | - Kyllä. | Sama normalisoitu lähde lähetetty ratkaistavaksi. |
output_ref | merkkijono | - Kyllä. | Tarkka tunnus ratkaisuvasteesta. |
tenant | merkkijono | Ei | Määrätty vuokralaisalue. Yleensä jätetään pois. |
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"}'transfer_ref.GET /v1/jobs/{transfer_ref} samalla avaimella.| Tila | Merkitys | Asiakastoiminta |
|---|---|---|
queued | Pääsi rajattuun jonoon. | Kysely uudelleen takaisinvedolla. |
extracting | Päivitetään lähdemetatietoja tai reittiä. | Jatka äänestystä. |
processing | Ladataan, remuxataan tai yhdistetään. | Näytä palvelimen edistyminen. |
ready | Allekirjoitettu lataus on saatavilla. | Lähetä URL-osoite käyttäjälle. |
failed | Päätelaitteen rakenteellinen virhe. | Lue error_codeYritä uudelleen vain, kun sitä kehotetaan. |
expired | Väliaikainen tuotos poistettiin. | Luo uusi työpaikka. |
curl https://downf.io/v1/jobs/TRANSFER_REF \
-H "X-API-Key: $DOWNF_ACCESS_TOKEN"DownF:n yhteensopivuusnäkymä tarkastelee yhden sekunnin alustavaa odotusta Job-kyselyn yhteydessä. Se näyttää seuraavan rajatun takaisinkytkennän eikä peitä väliaikaista allekirjoitettua toimitusta.
04
Ennustettavat virheet
DownF esittelee kolme käytännön kohtaa Error contractille. Ensimmäisenä tulee yksi non-2xx-kääre. Yhteensopivuusnäkymä kattaa sitten tukipyyntö-ID:n. Sen viimeinen kohta on ennustettava client-käsittely.
{
"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 | Tyypillinen merkitys | Toimi |
|---|---|---|
| 400 | Virheellinen URL-osoite, sisältö tai formaatti ei ole saatavilla. | Korjaa pyyntö. Ratkaise uudelleen formaateille. |
| 401 | Puuttuva, virheellinen, vanhentunut tai väärän laajuuden avain. | Tarkista palvelinpuolen tunnistetiedot. |
| 403 | Vuokralaisen tai lähdepolitiikan pyyntö hylättiin. | Älä ohita käytäntöä. Ota yhteyttä tukeen. |
| 404 | Tuntematon tai vanhentunut työpaikka. | Luo uusi tehtävä, jos tarpeen. |
| 429 | Pyyntö- tai aktiivisten tehtävien raja saavutettu. | Kunnia. retry_after_seconds. |
| 503 | Jono/kapasiteetti tai ylävirta tilapäisesti poissa käytöstä. | Yritä uudelleen eksponentiaalisella viiveellä ja häiriöllä. |
05
Toiminnan sopimus
DownF asettaa pyyntökaton tarkasteltuaan aiottua asiakasta, pitäen yhteensopivuustarkistuksensa ja ylävirran palveluntarjoajat vakaina.
- Käytä idempotenttia sovelluslogiikkaa äläkä koskaan käynnistä päällekkäisiä tehtäviä saman käyttäjän klikkauksesta.
- Välimuisti ratkaisee metatiedot lyhyesti, mutta käsittelee aina allekirjoitettuja lataus-URL-osoitteita vanhenevina.
- Käytä rajattua eksponentiaalista takaisinkytkentää häiriöllä varten
429,503ja uudelleenyritettävä virheitä. - Käsittele vain julkista mediaa tai mediaa, johon sinulla on oikeus. DRM- ja käyttöoikeusrajoituksia ei kiertää.
- Pidä pyyntö- ja työn tunnukset yksityisissä toimintalokeissa. Älä kirjaa lähetettyjä URL-osoitteita tarpeettomasti.
DownF järjestää Schema-pääsyn aktivoinnin ympärille ennen tutkimista. Sen yhteensopivuusnäkymä vertaa määritettyä tunnistautumista. Dokumentoidut pyyntörakenteet ovat lopullinen tarkistus.
Aktivoi tuen kautta
Kuvaile tuote, ennusta sen kuukausittaiset puhelut ja listaa alustat, joita sen on analysoitava. DownF-tuki vahvistaa vaaditut käyttöoikeusalueet ennen kuin se myöntää kertakäyttöisen näkyvän tunnistetiedon, jonka tallennettu kopio on vain tiiviste.
Pyydä aktivointia Avain on vuokralaiskohtainen, peruutettavissa ja myönnetään Yhteydenottolomakkeen kautta. Anonyymit skriptit eivät voi suorittaa lataustyötä.