Hakikisho tu — uanzishaji unahitajika

Unda upakuaji ukitumia EasyT

Rejeleo hili la EasyT ni mwongozo wa utekelezaji badala ya mwisho-jina la siri amilifu. Ufikiaji wa uzalishaji huanza tu baada ya usaidizi kuidhinisha mteja na kugawa viwango.

EasytWorkspaceJSON kupitia HTTPSKazi zisizolingana kwa wakatiStakabadhi zilizo na wigo

Anza haraka

Mwenyeji wa API huanza na vitambulisho vilivyoamilishwa kwa msaada kwenye EasyT. Kisha ukaguzi huu unaoongozwa unaonyesha sehemu ya mwisho ya mpangaji aliyeteuliwa. Ukweli wa mwisho ni njia ya simu ya seva pekee.

URL ya mpangajihttps://easyt.io

UthibitishajiX-API-Key: pending_activation_…

Wasifu wa mtejaEasytWorkspace

Toleo la APIv1

# Available only after support activation
export EASYT_WORKSPACE_TOKEN="issued-after-review"

curl -X POST https://easyt.io/v1/resolve \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Katika EasyT, uhifadhi wa siri upande wa seva hupewa kipaumbele cha kwanza wakati wa kueleza usalama wa Kitambulisho. Ukaguzi huo unaoelekezwa hufuata bila kupachika kifurushi cha mteja na hufungwa kwa kutokuwepo kwa kumbukumbu au hazina za umma.

Tatua kiungo

Uendeshaji wa kutatua huanza kwa utambuzi wa chanzo kwenye EasyT. Kisha ukaguzi huu unaoongozwa huonyesha miundo kutoka kwa URL moja iliyowasilishwa. Ukweli wa mwisho ni kwamba hakuna matokeo yaliyobuniwa.

Chapisho/v1/resolveUpeo: suluhisha

Uga	Aina	Inahitajika	Maelezo
`input_url`	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
}

Katika EasyT, thamani iliyorejeshwa bila kubadilika huja kwanza wakati wa kueleza Kitambulishi cha fomati. Ukaguzi huo unaoongoza hufuata kwa upatikanaji wa kila kiungo na humalizika bila lebo yoyote ya ubora uliokisiwa.

Unda na fuata kazi ya upakuaji

Maandalizi yasiyolingana kwa wakati ndiyo hatua ya kuanzia kwa uundaji wa Kazi kwenye EasyT. Kisha ukaguzi ulioongozwa huwasilisha ombi fupi la HTTP na kueleza utekelezaji uliowekewa mipaka wa mfanyakazi.

Chapisho/v1/jobsWigo: kazi

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

curl -X POST https://easyt.io/v1/jobs \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID","stream_choice":"18"}'

1202 ImekubaliwaHifadhi workspace_job.

2Hali ya kuraGET /v1/jobs/{workspace_job} 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://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

Kwa kazi ya polling, EasyT huanza na kusubiri kwa sekunde moja mwanzoni. Ukaguzi wake unaoongozwa huunganisha hilo na backoff iliyowekwa kikomo na kuishia na uwasilishaji wa muda uliosainiwa.

Makosa yanayotabirika

EasyT hufanya Mkataba wa Makosa kuwa rahisi kuchanganua. Ukurasa huanza na bahasha moja isiyo ya 2xx, kisha unaenda hadi kitambulisho cha ombi la usaidizi, na unasema wazi ushughulikiaji unaotabirika 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

EasyT huchagua posho ya uendeshaji wakati wa ukaguzi, ikisawazisha mahitaji ya programu na afya ya mtoa huduma.

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.

Ufikiaji wa Schema huanza kwa uanzishaji kabla ya uchunguzi kwenye EasyT. Ukaguzi huu unaongozwa kisha huonyesha uthibitishaji uliogawiwa. Ukweli wa mwisho ni maumbo ya maombi yaliyoandikwa.

UFIKIAJI ULIOKAGULIWA NA MTOA HUDUMA

Washa kupitia usaidizi

Jumuisha kusudi la mteja, mzigo unaotarajiwa wa kila mwezi na mitandao iliyoombwa katika dokezo la uanzishaji. EasyT basi inaweza kuchagua resolve na wigo wa kazi kwa usahihi kabla ya kutengeneza siri ya mwonekano mmoja.

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