Versionierung

BazaarLink stellt einen einzigen stabilen API-Pfad bereit, /v1 — es gibt keine datumsgebundenen Versionen oder Versions-Header zu verwalten. Die API entwickelt sich fortlaufend weiter statt über nummerierte Releases.

Nicht-brechende Änderungen

Diese werden ohne vorherige Ankündigung veröffentlicht:

Neue Endpunkte
Neue Modelle im Katalog
Neue optionale Anfrageparameter
Neue Antwortfelder
Neue Schemas mit optionalen Feldern
Zusätzliche Antwortstatus-/Fehlercodes

Clients defensiv schreiben

Ignorieren Sie Antwortfelder, die Sie nicht kennen, und scheitern Sie nicht an unbekannten Werten in enum-artigen Feldern — neue kommen hinzu, wenn Katalog und Funktionsumfang wachsen.

Breaking Changes

Diese sind selten und umfassen:

Entfernen oder Umbenennen eines Endpunkts, Parameters oder Antwortfelds
Ändern des Typs eines Felds
Verpflichtendmachen eines optionalen Parameters

Wenn sie vorkommen, betrifft ein Breaking Change einen bestimmten Endpunkt statt der gesamten /api/v1-Oberfläche — es gibt keinen einzelnen Versionssprung, der alle Integrationen gleichzeitig brechen könnte. Wir veröffentlichen noch kein formelles Changelog mit einem Breaking-Tag (siehe „Aktuell bleiben" unten) — bei integrationskritischen Fällen wenden Sie sich vorab an den Support, statt sich auf undokumentiertes Verhalten zu verlassen.

Deprecation-Richtlinie

Das eine routinemäßige „Breaking"-Ereignis, mit dem Sie rechnen sollten: einzelne Modelle werden abgeschaltet, wenn Upstream-Anbieter sie deprecaten. Fragen Sie den aktuellen Status eines Modells über GET /v1/models ab.

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

Aktuell bleiben

Wir veröffentlichen noch kein eigenes API-Changelog oder RSS-Feed. Prüfen Sie vorerst direkt diese Seite, verfolgen Sie den Status eines Modells über GET /v1/models, oder kontaktieren Sie den Support, wenn Sie für eine kritische Integration Vorlaufzeit benötigen.