Experimentelle Funktionen

Chargetrip führt bedeutende neue Funktionen über ein strukturiertes Experimentalprogramm ein. Es gibt Ihnen frühen Zugriff, um kommende Funktionen zu evaluieren und deren Design zu beeinflussen, bevor Schemas und Verträge dauerhaft werden.

Arten experimenteller Funktionen

• Neue Operationen: Völlig neue Queries, Mutationen oder Subscriptions.
• Erweiterungen bestehender Operationen: Neue optionale Argumente oder Ausgabefelder, die zu bestehenden stabilen Operationen hinzugefügt werden.

Phasen experimenteller Funktionen

Informationen darüber, was stabile Funktionen garantieren, finden Sie unter API-Lebenszyklus.

Bewährte Vorgehensweisen

• Verwenden Sie Alpha-Funktionen für Sandbox-Evaluierungen, Proofs of Concept und Feedback. Wenn Sie eine trotzdem produktiv 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 Funktionalität und Schema eine ausreichende Reife erreichen, wird die Funktion zu Beta graduiert. Das Beschreibungs-Tag wechselt von [ALPHA] zu [BETA], der Zugriff wird für alle Kunden standardmäßig 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 wurden, werden das Beschreibungs-Tag [BETA] und die Laufzeitwarnungen entfernt, und die Funktion wechselt in den stabilen Lebenszyklus.

Preise

• Anfragen an Operationen, die als experimentell gekennzeichnet sind, sind kostenlos.
• Anfragen an stabile Endpoints, die optionale experimentelle Eingabeargumente oder Ausgabefelder enthalten, werden gemäß Ihrem Abonnementplan 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, Warnungsmetadaten im GraphQL-extensions-Block 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."      }    ]  }}