Pembuatan versi

BazaarLink menyediakan satu jalur API stabil, /v1 — tidak ada versi berbasis tanggal atau header versi yang perlu dikelola. API berkembang secara berkelanjutan, bukan melalui rilis bernomor.

Perubahan Non-Breaking

Perubahan ini dirilis tanpa pemberitahuan sebelumnya:

Endpoint baru
Model baru ditambahkan ke katalog
Parameter permintaan opsional baru
Field respons baru
Skema baru dengan properti opsional
Kode status/error respons tambahan

Tulis klien secara defensif

Abaikan field respons yang tidak Anda kenali, dan jangan gagal pada nilai yang tidak dikenal di field bertipe enum — nilai baru ditambahkan seiring bertambahnya katalog dan fitur.

Perubahan Breaking

Perubahan ini jarang terjadi, dan mencakup:

Menghapus atau mengganti nama endpoint, parameter, atau field respons
Mengubah tipe suatu field
Menjadikan parameter opsional sebagai wajib

Jika terjadi, perubahan breaking berlaku pada endpoint tertentu, bukan seluruh permukaan /v1 — tidak ada satu lompatan versi yang bisa merusak semua integrasi sekaligus. Kami belum mempublikasikan changelog resmi dengan tag Breaking (lihat "Tetap Update" di bawah) — untuk hal yang kritis bagi integrasi Anda, hubungi Support sebelum mengandalkan perilaku yang tidak terdokumentasi.

Kebijakan Deprecation

Satu peristiwa "breaking" rutin yang perlu Anda antisipasi: model tertentu dipensiunkan seiring penyedia upstream men-deprecate-nya. Periksa status model saat ini melalui GET /v1/models.

1
2
3
4
5
6
7
GET https://api.bazaarlink.ai/v1/models
Authorization: Bearer sk-bl-YOUR_API_KEY

# A model within 30 days of its deprecation date shows in the catalog
# with an "EOL" badge on the Models page. After the effective date it's
# dropped from the catalog and calls return:
# 410 { "error": { "type": "model_not_available", "code": "model_retired" } }

Tetap Update

Kami belum mempublikasikan changelog API khusus atau RSS feed. Untuk saat ini, periksa langsung halaman ini, pantau status model melalui GET /v1/models, atau hubungi Support jika Anda memerlukan pemberitahuan lebih awal untuk integrasi yang kritis.