RoomScope

Terakhir diperbarui

Catatan perubahan

Apa saja yang berubah di API, dari yang terbaru. Perubahan yang tidak kompatibel dirilis di bawah prefix versi baru; semua yang ada di v1 tetap kompatibel dengan versi sebelumnya.

  1. DiubahHeader webhook diganti nama
    Pengiriman webhook kini membawa x-roomscope-signature, x-roomscope-timestamp, x-roomscope-alert-id, dan x-roomscope-schema-version. Skema penandatanganan dan payload tidak berubah; baca nama header yang baru saat melakukan verifikasi.
  2. DiperbaikiDokumentasi sesuai dengan API
    Error, Kredit, Batas laju, Autentikasi, dan Webhook kini menjelaskan perilaku yang sebenarnya berjalan: kode error yang nyata, batas laju per key dengan header X-RateLimit, biaya kredit dan jatah bulanan, serta skema webhook bertanda tangan. Referensi menambahkan insight kreator, waktu terbaik, dan kehadiran. Pencarian dokumentasi sudah aktif (⌘K).
  3. DitambahkanTemplate dokumentasi API
    Memulai, Autentikasi, Error, Batas laju, referensi Peringkat, dan Webhook. Halaman referensi untuk resource lainnya menyusul setelah dibuat dari dokumen OpenAPI.
  4. DiubahAmplop error
    Setiap error kini mengembalikan { code, message, requestId, retryable }. Klien sebaiknya menentukan alur berdasarkan code dan mencoba ulang hanya jika retryable bernilai true.
  5. DitambahkanPeringkat: blok asal data
    GET /v1/rankings/official mengembalikan objek provenance (coverageStatus, observedAt) di samping data.
  6. DitambahkanAPI key dengan scope
    Key membawa scope yang eksplisit (rank:read, live:read, creator:read, …). Permintaan di luar scope key gagal dengan 403 insufficient_scope.
Apakah halaman ini membantu?