버전 관리

BazaarLink는 단일 안정 API 경로인 /api/v1을 제공합니다 — 관리해야 할 날짜 고정 버전이나 버전 헤더가 없습니다. API는 번호가 매겨진 릴리스가 아니라 지속적으로 발전합니다.

비파괴적 변경

다음은 사전 공지 없이 배포됩니다:

새 엔드포인트
카탈로그에 새 모델 추가
새로운 선택적 요청 매개변수
새로운 응답 필드
선택적 속성을 가진 새 스키마
추가 응답 상태/오류 코드

방어적으로 클라이언트를 작성하세요

인식하지 못하는 응답 필드는 무시하고, enum 형태 필드의 알 수 없는 값에서 실패하지 않도록 하세요 — 카탈로그와 기능이 늘어나면서 새 값이 추가됩니다.

파괴적 변경

이는 드물게 발생하며, 다음을 포함합니다:

엔드포인트, 매개변수, 응답 필드를 제거하거나 이름을 바꾸는 것
필드 타입을 변경하는 것
선택적 매개변수를 필수로 만드는 것

발생하더라도 파괴적 변경은 전체 /v1 표면이 아니라 특정 엔드포인트에만 적용됩니다 — 모든 연동을 한 번에 깨뜨릴 수 있는 단일 버전 업그레이드는 없습니다. 아직 Breaking 태그가 있는 공식 changelog는 게시하지 않습니다(아래 "최신 정보 확인" 참고) — 연동에 중요한 부분이라면, 문서화되지 않은 동작에 의존하기 전에 Support에 문의하세요.

지원 종료 정책

예상해야 할 유일한 정기적인 "파괴적" 이벤트: 업스트림 공급자가 지원을 종료함에 따라 개별 모델이 폐지됩니다. 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" } }