Kernaussagen
- Modellieren Sie den gesamten Lebenszyklus, nicht nur die Profilerstellung.
- Behandeln Sie Bereitstellungs- und Nutzungsaktualisierungen als asynchron.
- Schützen Sie Aktivierungsdaten und Anmeldeinformationen.
- Bauen Sie von Anfang an eine Abstimmung auf, unterstützen Sie Transparenz und Fehlerbeseitigung.
Definieren Sie Systeme und Eigentum
Identifizieren Sie das Aufzeichnungssystem für Kunden-, Produkt-, Preis-, Bestell-, Zahlungs- und Konnektivitätsstatus. Viele Integrationsprobleme entstehen dadurch, dass zwei Systeme das gleiche Feld besitzen dürfen. Erstellen Sie Identifikatoren, die im gesamten Store, im Zahlungsabwickler und auf der Konnektivitätsplattform bestehen bleiben.
Dokumentieren Sie, welches System eine Bestellung erneut versuchen, stornieren, erstatten oder ändern darf. Definieren Sie die Supportansicht, damit Agenten dieselbe Transaktion finden können, ohne nach separaten Tools suchen zu müssen.
Entwerfen Sie die Kern-API-Abläufe
Ein typischer Ablauf ruft berechtigte Pläne ab, erstellt oder reserviert eine Bestellung, bestätigt die Zahlung, weist ein eSIM-Profil zu und gibt Aktivierungsinformationen zurück. Spätere Abläufe rufen Status und Nutzung ab, fügen Pakete hinzu, verarbeiten den Ablauf und unterstützen die Aussetzung oder den Ersatz, sofern das Produkt dies zulässt.
Halten Sie kommerzielle Produktkennzeichnungen getrennt von Netzwerk- oder Lieferantenkennzeichnungen. Dadurch bleibt das Kundenangebot stabil, wenn sich die zugrunde liegende Konnektivität ändert.
Verwenden Sie asynchrone Ereignisse sicher
Bereitstellung und Netzwerkaktualisierungen erfolgen nicht immer sofort. Webhooks oder Ereignisabfragen sollten den lokalen Status aktualisieren, ohne doppelte Aufträge zu erstellen. Überprüfen Sie Signaturen, speichern Sie Ereigniskennungen und verarbeiten Sie Ereignisse idempotent.
Stellen Sie Zustände wie „Ausstehend“, „Bereit“, „Installiert“, „Aktiv“, „Erschöpft“, „Abgelaufen“, „Angehalten“ und „Fehler“ explizit dar. Schließen Sie nicht auf Erfolg, nur weil eine API-Anfrage ohne Fehler zurückgegeben wurde.
Sichere Aktivierung und Kundendaten
Aktivierungscodes, QR-Daten, Kundenkennungen und API-Zugangsdaten erfordern entsprechende Zugriffskontrollen. Vermeiden Sie es, Geheimnisse in Protokolle oder Analysen zu schreiben. Verwenden Sie kurzlebige Anmeldeinformationen, sofern dies unterstützt wird, trennen Sie Produktions- und Testumgebungen und rotieren Sie Schlüssel.
Das zugrunde liegende eSIM-Zertifikat- und Bereitstellungsökosystem folgt den GSMA-Spezifikationen. Ihre Integration benötigt weiterhin Sicherheit auf Anwendungsebene, Datenschutzkontrollen und einen Vorfallprozess.
Testen und starten
Erstellen Sie Testfälle für doppelte Anfragen, Zeitüberschreitungen, verzögerte Webhooks, unzureichendes Guthaben, nicht verfügbare Pläne, Zahlungserfolg mit Bereitstellungsfehler, Aufladefehler, Rückerstattung und Support-Eskalation. Fügen Sie vor der Produktion Korrelations-IDs und Dashboards hinzu.
Starten Sie mit kontrolliertem Volumen, vergleichen Sie täglich Bestellungen mit Plattformdatensätzen und legen Sie fest, wer den Verkauf stoppen kann, wenn ein vorgelagertes Problem auftritt. Eine gute Integration ist ein Betriebsprozess, der durch Code unterstützt wird, nicht nur durch Code.
Fragen und Antworten
Was ist Idempotenz in einer eSIM-Bestell-API?
Das bedeutet, dass durch die Wiederholung derselben logischen Anfrage nicht mehrere Profile oder Gebühren erstellt werden. Verwenden Sie einen stabilen Idempotenzschlüssel und speichern Sie das Ergebnis.
Sollte ich Webhooks oder Polling verwenden?
Webhooks sorgen für schnellere Updates, während Polling die Wiederherstellung und den Abgleich unterstützen kann. Viele zuverlässige Integrationen nutzen beides.
Was sollte niemals protokolliert werden?
Vermeiden Sie die Protokollierung von API-Geheimnissen, vollständigen Aktivierungscodes, QR-Payloads, Zahlungsinformationen und unnötigen persönlichen Daten.