Experimentelle Funktionen

Chargetrip führt wesentliche neue Funktionen über ein strukturiertes Experimentalprogramm ein. Es gibt Ihnen frühzeitig Zugang, um kommende Funktionen zu bewerten und ihr Design mitzugestalten, bevor Schemas und Verträge endgültig werden.

Arten experimenteller Funktionen

• Neue Operationen: Vollständig neue Queries, Mutations oder Subscriptions.
• Erweiterungen bestehender Operationen: Neue optionale Argumente oder Ausgabefelder, die zu bestehenden stabilen Operationen hinzugefügt werden.

Phasen experimenteller Funktionen

Was stabile Funktionen garantieren, erfahren Sie unter API-Lebenszyklus.

Bewährte Vorgehensweisen

• Verwenden Sie Alpha-Funktionen für Tests in der Sandbox, Proofs of Concept und Feedback. Wenn Sie dennoch eine einsetzen, erhalten Sie bei Änderungen weder eine Benachrichtigung noch Kompatibilitätsschutz.
• Wenn Sie Beta-Funktionen für Endnutzer bereitstellen, zeigen Sie ein „Beta“-Badge an, damit diese wissen, dass sich die Funktion noch stabilisiert.

Graduierungs-Lebenszyklus

1. Alpha zu Beta

   Wenn Funktionsumfang und Schema ausreichend ausgereift sind, wird die Funktion zu Beta überführt. Die Beschreibungskennzeichnung wechselt von [ALPHA] zu [BETA], der Zugang wird standardmäßig für alle Kunden aktiviert, und die Änderungen werden in den Release Notes angekündigt.

2. Beta zu Stabil

   Wenn Zuverlässigkeit und Reife bei mehreren Clients bestätigt sind, werden die Beschreibungskennzeichnung [BETA] und die Laufzeitwarnungen entfernt, und die Funktion wechselt in den stabilen Lebenszyklus.

Preise

• Anfragen an als experimentell gekennzeichnete Operationen sind kostenlos.
• Anfragen an stabile Endpunkte, die optionale experimentelle Eingabeargumente oder Ausgabefelder enthalten, werden gemäß Ihrem Abonnement berechnet.

Programmatische Warnungen

Damit Ihr Entwicklungsteam experimentelle Abhängigkeiten im laufenden Datenverkehr im Blick behält, geben API-Antworten, die Alpha- oder Beta-Funktionen nutzen, Warnmetadaten im GraphQL-Block extensions zurück:

{  "data": {    "getTruckRoute": {      "id": "dd07b4d0-6b79-11f0-bf8f-e6b813282ac3",      "status": "done"    }  },  "extensions": {    "warnings": [      {        "code": "ALPHA_FEATURE",        "path": ["getTruckRoute"],        "message": "This feature is currently in ALPHA. Visit https://developers.chargetrip.com/api-reference for more information."      }    ]  }}

{  "data": {    "vehicleMakes": {      "name": "Opel"    }  },  "extensions": {    "warnings": [      {        "code": "BETA_FEATURE",        "path": ["vehicleMakes"],        "message": "This feature is currently in BETA. Visit https://developers.chargetrip.com/api-reference for more information."      }    ]  }}