Hakikisho tu — uanzishaji unahitajika

Unda upakuzi ukitumia FFast

FFast huonyesha muundo wa API unaokusudiwa bila kuwasha miito ya umma. Msimamizi huamilisha taarifa za uthibitishaji na viwango vya matumizi vilivyopimwa baada ya kuchunguza muunganisho uliopendekezwa.

FfastPipelineJSON kupitia HTTPSKazi zisizolingana kwa wakatiStakabadhi zilizo na wigo

Anza haraka

FFast hueleza seva ya API kwa kuanza na taarifa za uthibitishaji zilizoamilishwa na usaidizi, kisha sehemu ya mwisho iliyotengwa kwa tovuti. Mapitio ya haraka huweka wazi kwamba miito hufanywa kutoka seva pekee.

URL ya mpangajihttps://ffast.app

UthibitishajiX-API-Key: pending_activation_…

Wasifu wa mtejaFfastPipeline

Toleo la APIv1

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

Kwa usalama wa taarifa za uthibitishaji, FFast hukagua uhifadhi wa siri upande wa seva kabla ya kuhakikisha hazipachikwi katika kifurushi cha programu ya mteja. Mapitio haya ya haraka pia huweka wazi kutoweka siri katika kumbukumbu za matukio au hazina za umma.

Tatua kiungo

FFast hueleza operesheni ya utambuzi kwa kuanza na kutambua chanzo, kisha fomati kutoka URL moja iliyowasilishwa. Mapitio ya haraka huweka wazi kwamba matokeo hayabuniwi.

Chapisho/v1/resolveUpeo: suluhisha

Uga	Aina	Inahitajika	Maelezo
`fast_source`	URL ya HTTPS	Ndiyo	Ukurasa wa vyombo vya habari wa umma au ulioidhinishwa kuchambuliwa.
`tenant`	string	Hapana	Kikoa cha mpangaji kilichowekwa. Kawaida huachwa.

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

Kwa kitambulisho cha fomati, FFast hukagua thamani iliyorejeshwa bila kuibadilisha kabla ya upatikanaji kwa kila kiungo. Mapitio haya ya haraka pia huweka wazi kutobuni lebo ya ubora.

Unda na fuata kazi ya upakuaji

FFast hueleza uundaji wa kazi kwa kuanza na maandalizi yasiyosubiriwa na ombi. Kisha huangazia ombi fupi la HTTP na kuweka wazi utekelezaji wenye mipaka wa mchakataji.

Chapisho/v1/jobsWigo: kazi

Uga	Aina	Inahitajika	Maelezo
`fast_source`	URL ya HTTPS	Ndiyo	Chanzo kilekile kilichosanifishwa kilichowasilishwa ili kutatua.
`output_code`	string	Ndiyo	Kitambulisho kamili kutoka kwenye jibu la resolve.
`tenant`	string	Hapana	Kikoa cha mpangaji kilichowekwa. Kawaida huachwa.

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

1202 ImekubaliwaHifadhi pipeline_run.

2Hali ya kuraGET /v1/jobs/{pipeline_run} na ufunguo uleule.

3TayariFungua URL ya upakuaji iliyosainiwa.

Hali	Maana	Kitendo cha mteja
`queued`	Amekubaliwa kwenye foleni yenye kikomo.	Jaribu tena baadaye kwa kutumia kusubiri kwa muda unaoongezeka.
`extracting`	Kusasisha metadata ya chanzo au njia.	Endelea kupiga kura.
`processing`	Kupakua, kuunganishia upya au kuunganisha.	Onyesha maendeleo ya seva.
`ready`	Upakuaji uliosainiwa unapatikana.	Tuma URL kwa mtumiaji.
`failed`	Hitilafu iliyopangwa ya terminal.	Soma `error_code`. Jaribu tena tu unaposhauriwa.
`expired`	Matokeo ya muda yameondolewa.	Unda kazi mpya.

curl https://ffast.app/v1/jobs/PIPELINE_RUN \
  -H "X-API-Key: $FFAST_PIPELINE_KEY"

Job kupiga kura huanza na moja-pili awali kusubiri juu ya FFast. Mtazamo ujao inashughulikia capped backoff. Ukurasa anaendelea muda kusainiwa utoaji inayoonekana.

Makosa yanayotabirika

Mapitio ya haraka ya FFast hukagua muundo mmoja wa jibu lisilo la 2xx kwa mkataba wa hitilafu. Kisha huonyesha kitambulisho cha ombi la usaidizi na kuweka wazi ushughulikiaji unaotabirika upande wa mteja.

{
  "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	Maana ya kawaida	Kitendo
400	URL batili, mwili au umbizo halipatikani.	Rekebisha ombi. Tatua tena kwa ajili ya fomati.
401	Ufunguo haupo, si sahihi, muda wake umeisha, au una wigo usio sahihi.	Angalia kitambulisho cha upande wa seva.
403	Sera ya mpangaji au chanzo imekataa ombi.	Usipite sera. Wasiliana na usaidizi.
404	Kazi isiyojulikana au iliyokwisha muda wake.	Unda kazi mpya ikiwa inafaa.
429	Kikomo cha ombi au kazi inayotumika kimefikiwa.	Heshima `retry_after_seconds`.
503	Foleni/uwezo au huduma ya juu kwa muda haipatikani.	Jaribu tena kwa kutumia ucheleweshaji unaoongezeka kwa kasi na jitter.

Mkataba wa uendeshaji

FFast huamilisha viwango vya matumizi vilivyopimwa vinavyowezesha uhamishaji kuitikia haraka bila kuweka mzigo usio salama kwenye majukwaa ya chanzo.

Tumia mantiki ya programu inayotumika mara moja bila kuathiri matokeo na usianzishe kamwe kazi rudufu kwa kubofya kwa mtumiaji mmoja.
Hifadhi metadata ya kutatua kashe kwa muda mfupi, lakini daima chukulia URL za upakuaji zilizosainiwa kuwa zina muda wa kuisha.
Tumia kurudi nyuma kwa kasi yenye mipaka na mtikisiko kwa 429, 503 na makosa yanayoweza kujaribiwa tena.
Chakata tu maudhui ya umma au maudhui ambayo umeidhinishwa kuyafikia. DRM na vidhibiti vya ufikiaji havipitiwi.
Hifadhi vitambulisho vya ombi na vitambulisho vya kazi katika kumbukumbu za uendeshaji za faragha. Usirekodi URL zilizowasilishwa bila ulazima.

FFast hueleza ufikiaji wa schema kwa kuanza na uanzishaji kabla ya kuichunguza, kisha uthibitishaji uliotolewa. Mapitio ya haraka huweka wazi miundo ya maombi iliyoandikwa kwenye nyaraka.

UFIKIAJI ULIOKAGULIWA NA MTOA HUDUMA

Washa kupitia usaidizi

Ipe FFast muhtasari mfupi wa bidhaa, makadirio ya trafiki na orodha ya majukwaa. Eleza kama unahitaji ukaguzi wa metadata, kazi za kuandaa faili au vyote viwili ili ufunguo unaotolewa ulingane na mchakato halisi.

Omba uanzishaji Vifunguo vinahusiana na mpangaji, vinaweza kufutwa na hutolewa kupitia fomu ya Mawasiliano. Hati zisizojulikana haziwezi kutekeleza kazi ya kipakua.