Hakikisho tu — uanzishaji unahitajika

Jenga vipakuliwa kwa Insts

Benchi la kazi la Insts hapa chini ni nyaraka kwa mteja mtarajiwa. Mapitio ya mwendeshaji huja kabla ya ruhusa yoyote ya kitambulisho kinachotekelezeka au ya kupiga simu kuundwa.

InstsConnectJSON kupitia HTTPSKazi zisizolingana kwa wakatiStakabadhi zilizo na wigo

Anza haraka

Mwenyeji wa API huanza na vitambulisho vilivyoamilishwa vya usaidizi kwenye Insts. Mwonekano unaofuata unahusu kituo cha mpangaji kilichogawiwa. Ukurasa unaendelea kuonyesha njia ya kupiga simu ya upande wa seva pekee.

URL ya mpangajihttps://insts.io

UthibitishajiX-API-Key: pending_activation_…

Wasifu wa mtejaInstsConnect

Toleo la APIv1

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

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

Hifadhi ya siri upande wa seva ni hatua ya kuanzia kwa usalama wa Kitambulisho cha Kuingia kwenye Insts. Kisha benchi la ukaguzi linaonyesha hakuna kupachikwa kwa kifurushi cha mteja na linaeleza hakuna kumbukumbu za umma au hazina.

Tatua kiungo

Uendeshaji wa kusuluhisha huanza kwa kutambua chanzo kwenye Insts. Mwonekano unaofuata unashughulikia fomati kutoka kwa URL moja iliyowasilishwa. Ukurasa hauonyeshi matokeo yoyote yaliyobuniwa.

Chapisho/v1/resolveUpeo: suluhisha

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

Thamani iliyorejeshwa bila kubadilika ndiyo sehemu ya kuanzia kwa kitambulishi cha Umbizo kwenye Insts. Kisha benchi la ukaguzi linaonyesha upatikanaji kwa kila kiungo na linaeleza hakuna lebo ya ubora iliyokadiriwa.

Unda na fuata kazi ya upakuaji

Insts hufanya uundaji wa kazi kuwa rahisi kuchanganua. Ukurasa huanza na maandalizi ya asinkroni, huendelea kwa ombi fupi la HTTP, na huonyesha wazi utekelezaji wa mfanyakazi ulio na mipaka.

Chapisho/v1/jobsWigo: kazi

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

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

1202 ImekubaliwaHifadhi connect_job.

2Hali ya kuraGET /v1/jobs/{connect_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://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

Kwa ufuatiliaji wa Job, Insts hukagua subiri ya awali ya sekunde moja kabla ya ongezeko la kusubiri lililowekwa kikomo. Benchi hili la ukaguzi pia hufanya uwasilishaji wa muda uliosainiwa kuwa wazi.

Makosa yanayotabirika

Mkataba wa hitilafu huanza na bahasha moja isiyo ya 2xx kwenye Insts. Kisha benchi hili la ukaguzi linatoa kitambulisho cha ombi la usaidizi. Ukweli wa mwisho ni 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

Insts huweka mipaka ya viwango wakati wa uhakiki ili kulinda nafasi ya ukaguzi na kila njia 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 Insts. Mwonekano unaofuata unashughulikia uthibitishaji uliokabidhiwa. Ukurasa unaendelea kuonyesha maumbo ya maombi yaliyoandikwa.

UFIKIAJI ULIOKAGULIWA NA MTOA HUDUMA

Washa kupitia usaidizi

Shiriki kesi ya matumizi ya benchi la kazi, makadirio ya idadi ya miito na huduma zilizo chini ya ukaguzi. Insts hukagua mpaka huo kabla kitambulisho cha mpangaji kuonyeshwa mara moja na kubadilishwa kuwa heshi iliyohifadhiwa.

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