Pralihat sahaja — pengaktifan diperlukan

Bina muat turun dengan Insto

Insto membentangkan cetak biru integrasi visual-media untuk penilaian. Analisis langsung dan permintaan kerja kekal tidak tersedia sehingga sokongan memberikan kebenaran yang diskopkan oleh penyewa.

InstoMediaJSON melalui HTTPSTugas asinkronPengenalan yang diskopkan

Mulakan dengan cepat

Untuk hos API, Insto bermula dengan kelayakan yang diaktifkan sokongan. Ulasan muat turunnya berpasangan yang dengan titik akhir penyewa yang ditugaskan dan berakhir dengan laluan panggilan pelayan sahaja.

URL Penyewahttps://insto.app

PengesahanX-API-Key: pending_activation_…

Profil PelangganInstoMedia

Versi 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 mengemukakan tiga perkara praktikal untuk keselamatan Kredensial. Pertama adalah penyimpanan rahsia di sisi pelayan. Semakan muat turun kemudian merangkumi tiada penyisipan bundel klien. Perkara terakhirnya adalah tiada log awam atau repositori.

Menyelesaikan pautan

Untuk operasi Resolve, Insto bermula dengan pengesanan sumber. Semakan muat turun menggabungkan format dari satu URL yang dihantar dan berakhir tanpa output yang direka cipta.

POST/v1/resolveSkop: menyelesaikan

Medan	Jenis	Diperlukan	Huraian
`media_source`	URL HTTPS	Ya	Halaman media awam atau yang dibenarkan untuk dianalisis.
`tenant`	rentetan	Tidak	Domain penyewa yang ditugaskan. Biasanya ditinggalkan.

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

Insto membentangkan tiga titik praktikal untuk pengenal Format. Pertama datang nilai yang dikembalikan tidak berubah. Ulasan muat turun kemudian merangkumi ketersediaan per pautan. Titik terakhirnya adalah tiada label kualiti yang ditebak.

Cipta dan ikuti kerja muat turun

Insto mengatur Penciptaan Kerja sekitar persediaan asinkron. Ulasan muat turunnya membandingkan permintaan HTTP pendek. Pelaksanaan pekerja yang dibatasi tetap menjadi pemeriksaan terakhir.

POST/v1/jobsSkop: pekerjaan

Medan	Jenis	Diperlukan	Huraian
`media_source`	URL HTTPS	Ya	Sumber yang sama dinormalisasi dihantar untuk menyelesaikan.
`media_variant`	rentetan	Ya	ID yang tepat dari respons penyelesaian.
`tenant`	rentetan	Tidak	Domain penyewa yang ditugaskan. Biasanya ditinggalkan.

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 DiterimaSimpan prepare_id.

2Status undianGET /v1/jobs/{prepare_id} dengan kunci yang sama.

3SediaBuka URL muat turun yang ditandatangani.

Status	Makna	Tindakan Pelanggan
`queued`	Dibenarkan masuk ke barisan yang dibatasi.	Poll lagi dengan backoff.
`extracting`	Menyegar semula metadata sumber atau laluan.	Teruskan mengundi.
`processing`	Memuat turun, remuxing atau menggabungkan.	Papar kemajuan pelayan.
`ready`	Muat turun yang ditandatangani tersedia.	Hantar URL kepada pengguna.
`failed`	Ralat berstruktur terminal.	Baca `error_code`. Cuba semula hanya apabila dinasihatkan.
`expired`	Keluaran sementara dikeluarkan.	Cipta pekerjaan baru.

curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Dalam Insto, satu-detik awal menunggu datang pertama apabila menerangkan Jawatan polling. That muat turun ulasan berikut dengan capped backoff dan menutup pada penghantaran sementara ditandatangani.

Kesalahan yang boleh diramalkan

Untuk menerangkan Kontrak Ralat, Insto memisahkan satu sampul surat bukan 2xx dari ID permintaan sokongan Sebuah ulasan muat turun memberikan pengendalian pelanggan yang dapat diramalkan tempatnya sendiri.

{
  "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	Makna biasa	Tindakan
400	URL tidak sah, badan atau format tidak tersedia.	Betulkan permintaan. Selesaikan lagi untuk format.
401	Kunci hilang, tidak sah, tamat tempoh atau salah skop.	Semak kelayakan sisi pelayan.
403	Polisi penyewa atau sumber menolak permintaan.	Jangan mengelirukan dasar Hubungi sokongan.
404	Kerja yang tidak diketahui atau tamat tempoh.	Buat kerja baru jika sesuai.
429	Permintaan atau had aktif-kerja telah dicapai.	Kehormatan `retry_after_seconds`.
503	Baris gilir/kapasiti atau upstream tidak tersedia buat sementara waktu.	Cuba lagi dengan backoff eksponen dan jitter.

Kontrak operasi

Insto menjahit had panggilan kepada kes penggunaan visual-media dan rangkaian yang akan dihubungi oleh pelanggan yang diluluskan.

Gunakan logik aplikasi idempotent dan jangan pernah memulakan kerja berganda untuk klik pengguna yang sama.
Cache menyelesaikan metadata secara ringkas, tetapi sentiasa merawat URL muat turun yang ditandatangani sebagai tamat tempoh.
Gunakan backoff eksponen yang dibatasi dengan jitter untuk 429, 503 dan kesilapan yang boleh dicuba semula.
Proses hanya media awam atau media yang anda dibenarkan untuk mengakses. DRM dan kawalan akses tidak dipintas.
Simpan ID permintaan dan ID kerja dalam log operasi peribadi. Jangan log URL yang dihantar tanpa perlu.

Untuk akses Skema, Insto bermula dengan pengaktifan sebelum penerokaan. Ulasan muat turun menggabungkannya dengan pengesahan yang ditetapkan dan berakhir dengan bentuk permintaan yang didokumenkan.

AKSESS YANG DIPERIKSA OPERASI

Aktifkan melalui sokongan

Gambarkan produk media visual, penggunaan bulanan yang dijangka dan jenis catatan yang anda rancangkan untuk kendalikan. Insto hanya memberikan skop analisis atau penyediaan yang diperlukan dan tidak pernah menyimpan token yang boleh dibaca.

Minta pengaktifan Kunci adalah skop penyewa, boleh dibatalkan dan dikeluarkan melalui borang Hubungi. Skrip tanpa nama tidak dapat melaksanakan kerja pemuat turun.