Versionierung
Was sich innerhalb von Version 1 der Direct API ändern kann, was Ihr Client tolerieren muss und wie Modelle hinzugefügt und eingestellt werden.
Die Version steht im Pfad: /v1. Innerhalb von v1 sind Änderungen additiv: neue Tools, neue optionale Eingabefelder, neue Antwortfelder, neue Status, neue Ereignistypen und neue Fehlercodes.
Was Ihr Client verarbeiten muss
- Ignorieren Sie Antwortfelder, die Sie nicht kennen.
- Behandeln Sie einen Generierungsstatus, den Sie nicht kennen, als nicht endgültig und verfolgen Sie die Generierung weiter.
- Rechnen Sie damit, dass Eingabeschemas strikt bleiben: Ein unbekanntes Eingabefeld wird abgelehnt, sodass ein Tippfehler nie stillschweigend wirkungslos bleibt.
Inkompatible Änderungen
Eine inkompatible Änderung erscheint als /v2, mit mindestens 6 Monaten Überschneidung und einer Ankündigung an jede Organisation mit einem aktiven Schlüssel.
Modelle
- Modelle werden im Lauf der Zeit hinzugefügt und eingestellt; Modelle zeigt immer den aktuellen Bestand.
- Eine Modell-ID wird nie wiederverwendet und bleibt immer gültig. Eine eingestellte ID führt ihr Nachfolgemodell aus, und Antworten nennen das Modell, das tatsächlich ausgeführt wurde.
- Morphic darf die Engine hinter einer Modell-ID nur dann austauschen, wenn sie dadurch zum gleichen oder einem niedrigeren Preis besser wird, und kündigt dies im Modellkatalog an.
Wenn Sie Probleme haben oder Fragen haben, können Sie sich gerne an uns wenden. Wir helfen Ihnen gerne. Schreiben Sie uns an support@morphic.com.