การจัดการเวอร์ชัน

การจัดการเวอร์ชัน

BazaarLink เปิดให้ใช้ API path ที่เสถียรเพียงเส้นทางเดียวคือ /v1 — ไม่มีเวอร์ชันที่ผูกกับวันที่หรือ header เวอร์ชันให้ต้องจัดการ API มีการพัฒนาอย่างต่อเนื่องแทนที่จะออกเป็นรุ่นที่มีหมายเลข

การเปลี่ยนแปลงที่ไม่กระทบการทำงานเดิม

สิ่งเหล่านี้จะถูกปล่อยออกมาโดยไม่แจ้งล่วงหน้า:

• endpoint ใหม่
• โมเดลใหม่ที่เพิ่มเข้าแคตตาล็อก
• พารามิเตอร์คำขอที่เป็นตัวเลือกใหม่
• ฟิลด์การตอบกลับใหม่
• schema ใหม่ที่มีคุณสมบัติเป็นตัวเลือก
• รหัสสถานะ/ข้อผิดพลาดของการตอบกลับเพิ่มเติม

การเปลี่ยนแปลงที่กระทบการทำงานเดิม

สิ่งเหล่านี้เกิดขึ้นได้ยาก และครอบคลุม:

• การลบหรือเปลี่ยนชื่อ endpoint พารามิเตอร์ หรือฟิลด์การตอบกลับ
• การเปลี่ยนชนิดของฟิลด์
• การทำให้พารามิเตอร์ที่เป็นตัวเลือกกลายเป็นบังคับ

เมื่อเกิดขึ้นจริง การเปลี่ยนแปลงที่กระทบการทำงานเดิมจะใช้กับ endpoint เฉพาะเจาะจง ไม่ใช่ทั้งหมดของ /v1 — ไม่มีการเลื่อนเวอร์ชันครั้งเดียวที่จะทำให้ทุกการเชื่อมต่อพังพร้อมกัน เรายังไม่ได้เผยแพร่ changelog อย่างเป็นทางการที่มีแท็ก Breaking (ดู "ติดตามความเคลื่อนไหว" ด้านล่าง) — สำหรับสิ่งที่สำคัญต่อการเชื่อมต่อของคุณ กรุณาติดต่อ Support ก่อนที่จะพึ่งพาพฤติกรรมที่ไม่มีเอกสารรองรับ

นโยบายการเลิกใช้งาน

เหตุการณ์ "กระทบการทำงานเดิม" ตามปกติเพียงอย่างเดียวที่คุณควรคาดการณ์ไว้คือ โมเดลแต่ละตัวจะถูกเลิกใช้เมื่อผู้ให้บริการ upstream เลิกสนับสนุน ตรวจสอบสถานะปัจจุบันของโมเดลได้ผ่าน GET /v1/models

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

ติดตามความเคลื่อนไหว

เรายังไม่ได้เผยแพร่ API changelog หรือ RSS feed โดยเฉพาะ ในตอนนี้ให้ตรวจสอบหน้านี้โดยตรง ติดตามสถานะของโมเดลผ่าน GET /v1/models หรือติดต่อ Support หากคุณต้องการแจ้งเตือนล่วงหน้าสำหรับการเชื่อมต่อที่สำคัญ