Quản Lý Phiên Bản

Quản Lý Phiên Bản

BazaarLink cung cấp một đường dẫn API ổn định duy nhất, /v1 — không có phiên bản gắn theo ngày hay header phiên bản cần quản lý. API phát triển liên tục thay vì qua các bản phát hành đánh số.

Thay Đổi Không Phá Vỡ

Các thay đổi sau được triển khai mà không cần thông báo trước:

• Endpoint mới
• Mô hình mới được thêm vào danh mục
• Tham số yêu cầu tùy chọn mới
• Trường phản hồi mới
• Schema mới với thuộc tính tùy chọn
• Mã trạng thái/lỗi phản hồi bổ sung

Thay Đổi Phá Vỡ

Những thay đổi này hiếm khi xảy ra, bao gồm:

• Xóa hoặc đổi tên endpoint, tham số, hoặc trường phản hồi
• Thay đổi kiểu dữ liệu của một trường
• Biến tham số tùy chọn thành bắt buộc

Khi xảy ra, một thay đổi phá vỡ chỉ áp dụng cho một endpoint cụ thể chứ không phải toàn bộ /v1 — không có việc nâng phiên bản đơn lẻ nào có thể làm hỏng mọi tích hợp cùng lúc. Chúng tôi chưa công bố changelog chính thức có gắn nhãn Breaking (xem "Cập Nhật Thông Tin" bên dưới) — với những gì quan trọng cho tích hợp của bạn, hãy liên hệ Support trước khi dựa vào hành vi chưa được ghi trong tài liệu.

Chính Sách Ngừng Hỗ Trợ

Sự kiện "phá vỡ" định kỳ duy nhất bạn nên lường trước: từng mô hình bị ngừng hỗ trợ khi nhà cung cấp upstream loại bỏ chúng. Kiểm tra trạng thái hiện tại của một mô hình qua 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" } }

Cập Nhật Thông Tin

Chúng tôi chưa công bố changelog API riêng hay RSS feed. Hiện tại, hãy kiểm tra trực tiếp trang này, theo dõi trạng thái của mô hình qua GET /v1/models, hoặc liên hệ Support nếu bạn cần được thông báo trước cho một tích hợp quan trọng.