https://insto.appNgawangun unduhan sareng Insto
Insto nampilkeun blueprint integrasi visual-média pikeun evaluasi. Analisis langsung sareng pamundut padamelan tetep teu sayogi dugi dukungan masihan otorisasi anu diwatesan ku séwa.
InstoMediaJSON ngalangkungan HTTPSPakaryan asinkronKredensial anu diwatesan
01
Mimitian gancang
Pikeun host API, Insto dimimitian ku kredensial anu diaktipkeun ku dukungan. Tinjauan unduhan na pasangan éta sareng titik tungtung panyewa anu ditugaskeun sareng réngsé ku jalur telepon ngan ukur server.
X-API-Key: pending_activation_…InstoMediav1# 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 nampilkeun tilu titik praktis pikeun kaamanan Kredensial. Anu kahiji nyaéta panyimpenan rusiah sisi server. Tinjauan unduhan teras nyertakeun teu aya embedding bundel klien. Titik ahirna nyaéta teu aya log umum atawa repositori.
02
Ngarengsekeun hiji link
Pikeun operasi Resolve, Insto dimimitian ku deteksi sumber. Tinjauan unduhan na pasangan éta sareng format tina hiji URL anu dikirimkeun sareng réngsé tanpa kaluaran anu diciptakeun.
POST
/v1/resolveLingkup: ngarengsekeun| Medan | Tipe | Diperyogikeun | Katerangan |
|---|---|---|---|
media_source | URL HTTPS | Leres | Halaman média umum atanapi anu diidinan pikeun dianalisis. |
tenant | string | Henteu | Ditugaskeun domain panyewa. Biasana dileungitkeun. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Insto nampilkeun tilu titik praktis pikeun idéntifikasi Format. Anu kahiji nyaéta nilai anu dipulangkeun tanpa robahan. Tinjauan unduhan teras ngaliput kasadiaan per-tautan. Titik ahirna nyaéta teu aya labél kualitas anu ditebak.
03
Nyiptakeun sareng nuturkeun padamelan unduhan
Insto ngatur kreasi Pakaryan sakitar persiapan asynchronous. Tinjauan unduhan na ngabandingkeun pamundut HTTP pondok. Palaksanaan pagawé anu dibatesan tetep janten cek akhir.
POST
/v1/jobsLingkup: padamelan| Medan | Tipe | Diperyogikeun | Katerangan |
|---|---|---|---|
media_source | URL HTTPS | Leres | Sumber normalisasi anu sami diserahkeun pikeun direngsekeun. |
media_variant | string | Leres | ID anu pasti tina réspon ngarengsekeun. |
tenant | string | Henteu | Ditugaskeun domain panyewa. Biasana dileungitkeun. |
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"}'prepare_id.GET /v1/jobs/{prepare_id} kalayan konci anu sami.| Status | Harti | Tindakan klien |
|---|---|---|
queued | Ditampi kana antrian anu diwatesan. | Poll deui sareng backoff. |
extracting | Ngarefresh metadata sumber atanapi rute. | Teruskeun polling. |
processing | Ngaunduh, remuxing atanapi ngahijikeun. | Tampilan kamajuan server. |
ready | Unduh anu ditandatanganan sayogi. | Kirimkeun URL ka pangguna. |
failed | Kasalahan struktur terminal. | Baca error_code. Coba deui ngan ukur nalika disarankeun. |
expired | Kaluaran samentawis dipiceun. | Nyiptakeun padamelan anyar. |
curl https://insto.app/v1/jobs/PREPARE_ID \
-H "X-API-Key: $INSTO_MEDIA_TOKEN"Dina Insto, hiji-detik mimiti ngantosan datangna mimiti nalika ngajelaskeun polling Pakaryan. Éta ulasan unduhan nuturkeun sareng capped backoff sareng nutup dina pangiriman anu ditandatanganan samentawis.
04
Kasalahan anu tiasa diprediksi
Pikeun ngajelaskeun Kontrak Kasalahan, Insto misahkeun hiji amplop non-2xx tina ID pamundut dukungan. Tinjauan unduhan masihan klien anu tiasa diprediksi nanganan tempatna nyalira.
{
"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 | Harti anu khas | Aksi |
|---|---|---|
| 400 | URL anu henteu valid, awak atanapi format anu teu aya. | Ngabenerkeun pamundut. Ngarengsekeun deui pikeun format. |
| 401 | Konci leungit, henteu valid, kadaluarsa atanapi salah-ruang lingkup. | Pariksa kredensial sisi server. |
| 403 | Panyewa atanapi kabijakan sumber nolak pamundut. | Ulah bypass kawijakan. Hubungi rojongan. |
| 404 | Pakaryan anu teu dikenal atanapi kadaluarsana. | Nyiptakeun padamelan énggal upami cocog. |
| 429 | Kéngingkeun atanapi aktip-pakaryan wates ngahontal. | Honor retry_after_seconds. |
| 503 | Antrian/kapasitas atawa upstream keur teu aya samentara. | Coba deui sareng backoff éksponénsial sareng jitter. |
05
Kontrak operasi
Insto tailors nelepon watesan kana kasus pamakéan visual-média jeung jaringan anu disatujuan klien bakal ngahubungan.
- Anggo logika aplikasi idempotent sareng henteu kantos ngamimitian padamelan duplikat pikeun pangguna anu sami klik.
- Cache metadata résolusi sacara singget, tapi sok anggap URL unduhan anu ditandatanganan salaku kadaluwarsa.
- Anggo backoff éksponénsial anu dibatesan sareng jitter pikeun
429,503sareng kasalahan anu tiasa diusahakeun deui. - Ngolah ngan ukur média umum atanapi média anu anjeun diidinan pikeun ngaksés. DRM sareng kontrol aksés henteu dipaliré.
- Ngajaga ID pamundut sareng ID padamelan dina log operasi pribadi. Ulah log URL anu dikirimkeun tanpa perlu.
Pikeun aksés Schema, Insto dimimitian ku aktivasina sateuacan éksplorasi. Tinjauan unduhan na pasangan éta sareng otentikasi anu ditugaskeun sareng réngsé ku bentuk pamundut anu didokumentasikeun.
Aktipkeun ngalangkungan dukungan
Gambarkeun produk média visual, pamakean bulanan anu dipiharep sareng jinis pos anu anjeun rencanakeun pikeun diatur. Insto ngan ukur masihan lingkup analisa atanapi persiapan anu diperyogikeun sareng henteu pernah nyimpen token anu tiasa dibaca.
Kéngingkeun aktivasina Konci téh diwatesan ku panyewa, bisa dibatalkeun jeung dikaluarkeun ngaliwatan formulir Kontak. Skrip anonim teu bisa ngalaksanakeun pagawéan pangunduh.