https://ffast.appRakenna lataukset FFast: llä
FFast paljastaa suunnitellun API-rakenteen ottamatta julkisia kutsuja käyttöön. Operaattori aktivoi tunnistetiedot ja mitatut kiintiöt tutkittuaan ehdotetun integroinnin.
Pika-aloitus
FFast lähestyy API-isäntää tuen aktivoimien tunnistetietojen kautta, sitten määritetyn vuokraajan päätepisteen Nopea tarkastelu pitää vain palvelimen puhelupolun selkeänä.
X-API-Key: pending_activation_…FfastPipelinev1# Available only after support activation
export FFAST_PIPELINE_KEY="issued-after-review"
curl -X POST https://ffast.app/v1/resolve \
-H "X-API-Key: $FFAST_PIPELINE_KEY" \
-H "Content-Type: application/json" \
-d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'Tunnistetietojen turvallisuuden vuoksi FFast tarkistaa palvelinpuolen salaisen tallennuksen eikä upota mitään asiakaspuolen pakettiin. Tämä nopea tarkistus ei myöskään paljasta julkisia lokitietoja tai repositorioita.
Linkin ratkaiseminen
FFast lähestyy Resolve-toimintoa lähdetunnistuksen kautta, sitten muotoilee yhdestä lähetetystä URL-osoitteesta. Nopea arvostelu ei pidä mitään keksittyjä tuotoksi eksplisiittisesti.
/v1/resolveLaajuus: ratkaista| Kenttä | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
fast_source | 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
}Muototunnisteelle FFast tarkistaa palautetun arvon muuttumattomana ennen linkkikohtaista saatavuutta. Tämä nopea tarkastelu ei myöskään tee mitään arvaamatonta laatumerkintää selväksi.
Luo ja seuraa lataustehtävää
FFast käsittelee työn luomisen tunnistamalla ensin asynkronisen valmistelun, jonka jälkeen se lähettää lyhyen HTTP-pyynnön ja pitää rajatun työntekijän suorituksen näkyvissä.
/v1/jobsLaajuus: työpaikat| Kenttä | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
fast_source | HTTPS- URL | - Kyllä. | Sama normalisoitu lähde lähetetty ratkaistavaksi. |
output_code | merkkijono | - Kyllä. | Tarkka tunnus ratkaisuvasteesta. |
tenant | merkkijono | Ei | Määrätty vuokralaisalue. Yleensä jätetään pois. |
curl -X POST https://ffast.app/v1/jobs \
-H "X-API-Key: $FFAST_PIPELINE_KEY" \
-H "Content-Type: application/json" \
-d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID","output_code":"18"}'pipeline_run.GET /v1/jobs/{pipeline_run} 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://ffast.app/v1/jobs/PIPELINE_RUN \
-H "X-API-Key: $FFAST_PIPELINE_KEY"Työjonon kysely alkaa yhden sekunnin alkoviiveellä FFast:ssa. Seuraava näkymä kattaa ylärajoitetun takaisinkytkennän. Sivu pitää tilapäisen allekirjoitetun toimituksen näkyvissä.
Ennustettavat virheet
FFast:n nopea katsaus arvioi yhden ei-2xx-kuoren Error-sopimusta varten. Se näyttää seuraavaksi tukipyynnön tunnuksen eikä peitä ennustettavaa asiakaskä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ä. |
Toiminnan sopimus
FFast aktivoi mitatut kiintiöt, jotka pitävät siirron responsiivisena ilman, että ne kuormittavat vaarallisesti ylävirran alustoja.
- 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.
FFast lähestyy Schema-käyttöä aktivoitumisen kautta ennen tutkimista, sitten sille määritettyä todennusta. Nopea tarkastelu pitää dokumentoidut pyyntömuodot selkeinä.
Aktivoi tuen kautta
Anna FFast tiivis tuoteyhteenveto, liikenne-ennuste ja alustaluettelo. Ilmoita, tarvitaanko metatietotarkistuksia, valmiiksi valmisteltuja töitä vai molempia, jotta myönnetty avain vastaa todellista työnkulkua.
Pyydä aktivointia Avain on vuokralaiskohtainen, peruutettavissa ja myönnetään Yhteydenottolomakkeen kautta. Anonyymit skriptit eivät voi suorittaa lataustyötä.