Версии

Версии

BazaarLink предоставляет единый стабильный путь API, /v1 — нет привязанных к дате версий или заголовков версий, которыми нужно управлять. API развивается постоянно, а не через пронумерованные выпуски.

Некритичные изменения

Отправка без предварительного уведомления:

• Новые конечные точки
• В каталог добавлены новые модели
• Новые дополнительные параметры запроса
• Новые поля ответа
• Новые схемы с дополнительными свойствами
• Дополнительные коды ответа status/error

Важные изменения

Это редкие экземпляры, включая:

• Удаление или переименование конечной точки, параметра или поля ответа.
• Изменение типа поля
• Сделать обязательным дополнительный параметр

Когда они все-таки происходят, критическое изменение применяется к конкретной конечной точке, а не ко всей поверхности /v1 — не существует какого-либо одного изменения версии, которое могло бы нарушить всю интеграцию сразу. Мы пока не публикуем официальный журнал изменений с пометкой «Критические изменения» (см. «Остаться в курсе» ниже); по вопросам, важным для интеграции, обращайтесь в службу поддержки, прежде чем полагаться на недокументированное поведение.

Политика прекращения поддержки

Одно обычное «критическое» событие, которого следует ожидать: отдельные модели выводятся из эксплуатации, поскольку вышестоящие поставщики устаревают. Запросите текущий статус модели через 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 или канал RSS. На данный момент проверьте эту страницу напрямую, посмотрите статус модели через GET /v1/models или обратитесь в службу поддержки, если вам нужно предварительное уведомление о критической интеграции.