Pratinjau saja — aktivasi diperlukan

Bangun unduhan dengan Insto

Insto menyajikan cetak biru integrasi visual-media untuk evaluasi. Analisis langsung dan permintaan pekerjaan tetap tidak tersedia sampai dukungan memberikan otorisasi yang dijangkau oleh tenant.

InstoMediaJSON melalui HTTPSTugas asinkronKredensial yang dijangkau

Awal yang cepat

Untuk host API, Insto dimulai dengan kredensial yang diaktifkan dukungan. Ulasan unduhannya berpasangan itu dengan titik akhir tenant yang ditugaskan dan berakhir dengan jalur panggilan hanya server.

URL Tenanthttps://insto.app

OtentikasiX-API-Key: pending_activation_…

Profil klienInstoMedia

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 menyajikan tiga poin praktis untuk keamanan Kredensial. Pertama adalah penyimpanan rahasia di sisi server. Tinjauan unduhan kemudian mencakup tidak ada penyematan bundel klien. Poin terakhirnya adalah tidak ada log atau repositori publik.

Menyelesaikan sebuah tautan

Untuk operasi Resolve, Insto dimulai dengan deteksi sumber. Ulasan unduhannya berpasangan itu dengan format dari satu URL yang diajukan dan berakhir dengan tidak ada keluaran yang ditemukan.

POST/v1/resolveScope: menyelesaikan

Medan	Jenis	Diperlukan	Deskripsi
`media_source`	URL HTTPS	Ya	Halaman media publik atau resmi untuk dianalisis.
`tenant`	string	Tidak.	Domain penyewa yang ditetapkan. Biasanya dihilangkan.

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

Insto menyajikan tiga poin praktis untuk pengenal Format. Pertama datang nilai yang dikembalikan tidak berubah. Ulasan unduhan kemudian mencakup ketersediaan per tautan. Poin terakhirnya adalah tidak ada label kualitas yang ditebak.

Buat dan ikuti pekerjaan unduhan

Insto mengatur penciptaan Pekerjaan di sekitar persiapan asinkron. Ulasan unduhannya membandingkan permintaan HTTP singkat. Eksekusi pekerja terbatas tetap menjadi pemeriksaan terakhir.

POST/v1/jobsLingkup: pekerjaan

Medan	Jenis	Diperlukan	Deskripsi
`media_source`	URL HTTPS	Ya	Sumber yang dinormalisasi sama diajukan untuk diselesaikan.
`media_variant`	string	Ya	ID tepat dari respons penyelesaian.
`tenant`	string	Tidak.	Domain penyewa yang ditetapkan. Biasanya dihilangkan.

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 PollGET /v1/jobs/{prepare_id} dengan kunci yang sama.

3SiapBuka URL unduhan yang ditandatangani.

Status	Artinya	Tindakan klien
`queued`	Diterima ke antrian terbatas.	Poll lagi dengan backoff.
`extracting`	Menyegarkan metadata sumber atau rute.	Lanjutkan polling.
`processing`	Mengunduh, meremux, atau menggabungkan.	Tunjukkan kemajuan server.
`ready`	Unduh yang ditandatangani tersedia.	Kirim URL ke pengguna.
`failed`	Kesalahan struktur terminal.	Baca `error_code`. Coba ulang hanya ketika dianjurkan.
`expired`	Keluaran sementara dihapus.	Buat 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 ketika menjelaskan Pekerjaan polling. Bahwa ulasan unduhan mengikuti dengan capped backoff dan menutup pada pengiriman sementara ditandatangani.

Kesalahan yang dapat diprediksi

Untuk menjelaskan Kontrak Error, Insto memisahkan satu amplop non-2xx dari ID permintaan dukungan. Sebuah ulasan unduhan memberikan penanganan klien yang dapat diprediksi 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	Arti yang khas	Action
400	URL tidak valid, isi atau format tidak tersedia.	Perbaiki permintaan. Selesaikan lagi untuk format.
401	Kunci hilang, tidak valid, kedaluwarsa, atau cakupan salah.	Periksa kredensial sisi server.
403	Kebijakan penyewa atau sumber menolak permintaan.	Jangan melewati kebijakan. Hubungi dukungan.
404	Pekerjaan yang tidak diketahui atau kadaluarsa.	Buat pekerjaan baru jika sesuai.
429	Batas permintaan atau pekerjaan aktif telah tercapai.	Kehormatan `retry_after_seconds`.
503	Antrian/kapasitas atau hulu sementara tidak tersedia.	Coba lagi dengan penundaan eksponensial dan jitter.

Kontrak operasional

Insto menyesuaikan batas panggilan dengan kasus penggunaan visual-media dan jaringan yang akan dihubungi klien yang disetujui.

Gunakan logika aplikasi idempotent dan jangan pernah memulai pekerjaan duplikat untuk klik pengguna yang sama.
Cache menyelesaikan metadata secara singkat, tetapi selalu memperlakukan URL unduhan yang ditandatangani sebagai berakhir.
Gunakan bounded exponential backoff dengan jitter untuk 429, 503 dan kesalahan yang dapat dicoba kembali.
Proses hanya media publik atau media yang Anda diizinkan untuk mengakses. DRM dan kontrol akses tidak dihindari.
Simpan ID permintaan dan ID pekerjaan dalam log operasional pribadi. Jangan log URL yang diajukan tanpa perlu.

Untuk akses Schema, Insto dimulai dengan aktivasi sebelum eksplorasi. Ulasan unduhannya berpasangan yang dengan otentikasi yang ditugaskan dan berakhir dengan bentuk permintaan yang terdokumentasi.

AKSESS YANG DIPERIKSA OPERATO

Aktifkan melalui dukungan

Gambarkan produk media visual, perkiraan penggunaan bulanan, dan jenis posting yang Anda rencanakan untuk ditangani. Insto hanya memberikan ruang lingkup analisis atau persiapan yang diperlukan dan tidak pernah menyimpan token yang dapat dibaca.

Minta aktivasi Kunci adalah tenant-scoped, dapat dicabut dan dikeluarkan melalui formulir Kontak. Skrip anonim tidak dapat menjalankan pekerjaan pengunduh.