Pratinjau saja — aktivasi diperlukan

Bangun unduhan dengan Insts

Workbench Insts di bawah ini adalah dokumentasi untuk calon klien. Tinjauan operator datang sebelum kredensial yang dapat dieksekusi atau tunjangan panggilan dibuat.

InstsConnectJSON melalui HTTPSTugas asinkronKredensial yang dijangkau

Awal yang cepat

API host dimulai dengan kredensial yang diaktifkan dukungan pada Insts. Tampilan berikutnya mencakup titik akhir tenant yang ditugaskan. Halaman ini menjaga jalur panggilan hanya server yang terlihat.

URL Tenanthttps://insts.io

OtentikasiX-API-Key: pending_activation_…

Profil klienInstsConnect

Versi 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"}'

Penyimpanan rahasia sisi server adalah titik awal untuk keamanan Kredensial di Insts. Sebuah meja inspeksi kemudian menampilkan tidak ada penyematan bundel klien dan menjelaskan tidak ada log publik atau repositori.

Menyelesaikan sebuah tautan

Operasi penyelesaian dimulai dengan deteksi sumber pada Insts. Tampilan berikutnya mencakup format dari satu URL yang diajukan. Halaman menyimpan tidak ada keluaran yang diciptakan yang terlihat.

POST/v1/resolveScope: menyelesaikan

Medan	Jenis	Diperlukan	Deskripsi
`shared_post`	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
}

Nilai yang dikembalikan tidak berubah adalah titik awal untuk Format identifikator pada Insts. Sebuah bangku inspeksi kemudian menyajikan ketersediaan per-link dan menjelaskan tidak ada label kualitas yang ditebak.

Buat dan ikuti pekerjaan unduhan

Insts membuat Penciptaan pekerjaan mudah untuk dipindai. Halaman dimulai dengan persiapan asinkron, bergerak ke permintaan HTTP singkat, dan dengan jelas menyatakan eksekusi pekerja terbatas.

POST/v1/jobsLingkup: pekerjaan

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

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

2Status PollGET /v1/jobs/{connect_job} 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://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

Untuk polling Job, Insts memeriksa satu detik awal menunggu sebelum backoff capped. ini inspeksi bangku juga membuat pengiriman sementara ditandatangani jelas.

Kesalahan yang dapat diprediksi

Kontrak kesalahan dimulai dengan satu amplop non-2xx pada Insts. Kursi inspeksi ini kemudian menyajikan ID permintaan dukungan. Fakta terakhir adalah penanganan klien yang dapat diprediksi.

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

Insts menetapkan batas tarif pada waktu tinjauan untuk melindungi ruang kerja inspeksi dan setiap rute penyedia.

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.

Akses skema dimulai dengan aktivasi sebelum eksplorasi pada Insts. Tampilan berikutnya mencakup otentikasi yang ditugaskan. Halaman ini menjaga bentuk permintaan yang terdokumentasi terlihat.

AKSESS YANG DIPERIKSA OPERATO

Aktifkan melalui dukungan

Bagikan kasus penggunaan workbench, perkiraan jumlah panggilan dan layanan yang sedang diperiksa.Insts meninjau batas itu sebelum kredensial tenant ditampilkan sekali dan dikurangi menjadi hash yang tersimpan.

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