Hakikisho tu — uanzishaji unahitajika

Unda vipakuliwa kwa kutumia Insto

Insto inatoa mpango wa ujumuishaji wa midia ya kuona kwa ajili ya tathmini. Uchambuzi wa moja kwa moja na maombi ya kazi hubaki hayapatikani hadi usaidizi utoe idhini iliyo ndani ya wigo wa mpangaji.

InstoMediaJSON kupitia HTTPSKazi zisizolingana kwa wakatiStakabadhi zilizo na wigo

Anza haraka

Kwa seva pangishi ya API, Insto huanza na vitambulisho vilivyoamilishwa na usaidizi. Ukaguzi wake wa upakuaji huoanisha hiyo na mwisho wa mpangaji uliogawiwa na kuishia na njia ya mwito ya seva pekee.

URL ya mpangajihttps://insto.app

UthibitishajiX-API-Key: pending_activation_…

Wasifu wa mtejaInstoMedia

Toleo la APIv1

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

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

Insto inatoa mambo matatu ya vitendo kwa usalama wa Vitambulisho. Kwanza ni uhifadhi wa siri upande wa seva. Ukaguzi wa upakuaji kisha unashughulikia kutopachika kwenye kifurushi cha mteja. Hoja yake ya mwisho ni kutokuwa na kumbukumbu za umma au hazina za umma.

Tatua kiungo

Kwa operesheni ya Resolve, Insto huanza na utambuzi wa chanzo. Tathmini yake ya upakuaji huoanisha hilo na fomati kutoka kwa URL moja iliyowasilishwa na huisha bila matokeo yaliyobuniwa.

Chapisho/v1/resolveUpeo: suluhisha

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

Insto inawasilisha pointi tatu za vitendo kwa Kitambulisho cha fomati. Kwanza huja thamani iliyorejeshwa bila kubadilika. Kisha uhakiki wa upakuaji unashughulikia upatikanaji kwa kila kiungo. Hatimaye, hakuna lebo ya ubora iliyokadiriwa.

Unda na fuata kazi ya upakuaji

Insto hupanga uundaji wa Kazi kuzunguka maandalizi yasiyosawazika. Ukaguzi wake wa upakuaji unalinganisha ombi fupi la HTTP. Utekelezaji wa mfanyakazi uliowekewa mipaka unabaki kuwa ukaguzi wa mwisho.

Chapisho/v1/jobsWigo: kazi

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

curl -X POST https://insto.app/v1/jobs \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_source":"https://www.youtube.com/watch?v=VIDEO_ID","media_variant":"18"}'

1202 ImekubaliwaHifadhi prepare_id.

2Hali ya kuraGET /v1/jobs/{prepare_id} 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://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Katika Insto, kusubiri kwa awali kwa sekunde moja huja kwanza wakati wa kueleza uchunguzi wa Kazi. Mapitio hayo ya upakuaji hufuata kwa kuchelewesha kwa kiwango cha juu na hufungwa kwa utoaji wa muda uliosainiwa.

Makosa yanayotabirika

Kuelezea Error contract, Insto hutenganisha bahasha moja isiyo ya 2xx kutoka kwa kitambulisho cha ombi la usaidizi. Uhakiki wa upakuaji hutoa ushughulikiaji wa mteja unaotabirika mahali pake mwenyewe.

{
  "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

Insto hurekebisha viwango vya simu kulingana na matumizi ya vyombo vya habari vya kuona na mitandao ambayo mteja aliyeidhinishwa atawasiliana nayo.

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.

Kwa ufikiaji wa Schema, Insto huanza na uanzishaji kabla ya uchunguzi. Uhakiki wake wa upakuaji huoanisha hilo na uthibitishaji uliowekwa na huisha na maumbo ya maombi yaliyoandikwa.

UFIKIAJI ULIOKAGULIWA NA MTOA HUDUMA

Washa kupitia usaidizi

Eleza bidhaa ya vyombo vya habari vya picha, matumizi ya kila mwezi yanayotarajiwa na aina za machapisho unayopanga kushughulikia. Insto huipa tu ruhusa za uchanganuzi au maandalizi zinazohitajika na kamwe haihifadhi tokeni inayosomeka.

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