Pembuatan versi
Apa yang dapat berubah dalam versi 1 Direct API, apa yang harus ditoleransi klien Anda, dan bagaimana model ditambahkan serta dipensiunkan.
Versi tercantum di path: /v1. Dalam v1, perubahan bersifat aditif: alat baru, field input opsional baru, field respons baru, status baru, jenis event baru, dan kode error baru.
Yang harus ditangani klien Anda
- Abaikan field respons yang tidak Anda kenal.
- Anggap status generasi yang tidak Anda kenal sebagai belum final, dan teruslah memantaunya.
- Skema input tetap ketat: field input yang tidak dikenal akan ditolak, sehingga salah ketik tidak pernah diam-diam tidak berpengaruh.
Perubahan yang merusak kompatibilitas
Perubahan yang merusak kompatibilitas dirilis sebagai /v2, dengan masa tumpang tindih setidaknya 6 bulan dan pemberitahuan kepada setiap organisasi yang memiliki kunci aktif.
Model
- Model ditambahkan dan dipensiunkan dari waktu ke waktu; Model selalu menampilkan kumpulan model saat ini.
- Id model tidak pernah dipakai ulang dan tidak pernah berhenti diterima. Id yang sudah dipensiunkan menjalankan penggantinya, dan respons menyebutkan model yang benar-benar dijalankan.
- Morphic dapat mengganti mesin di balik sebuah id model hanya untuk meningkatkannya dengan harga yang sama atau lebih rendah, dan mengumumkannya di katalog model.
Jika Anda mengalami kendala atau memiliki pertanyaan, jangan ragu untuk menghubungi kami. Kami dengan senang hati akan membantu. Tulis kepada kami di support@morphic.com.