Mobile Daten in Ihre App integrieren.
Nutzen Sie die eSIM-API, um Datenangebote zu entdecken, Pakete zu kaufen und private Installationslinks aus Ihrer Anwendung zu versenden. Halten Sie Kunden in Ihrem eigenen Kontoerlebnis für gemeldete Guthaben, kompatible Aufladungen und wiederkehrende Käufe, sofern verfügbar.
Starten Sie mit den verfügbaren Angeboten.
Verwenden Sie einen serverseitigen API-Schlüssel mit eSIM-Leseberechtigung, um den Katalog zu durchsuchen. Dieses Beispiel listet Angebote auf, ohne ein Paket zu kaufen.
bird esim offers listVom Angebot zur Bestellung
Verwandeln Sie ein Angebot in einen wiederherstellbaren Kauf.
Lesen Sie Abdeckung, Volumen und Gültigkeit des Angebots und rufen Sie dann den aktuellen Checkout-Preis ab. Ihr Organisations-Wallet finanziert den Kauf. Speichern Sie die resultierende Bestellung, damit der Kunde darauf zurückkommen kann, während Bird die eSIM und das Datenpaket bereitstellt.
Akzeptierte Bedingungen anzeigen
Senden Sie die akzeptierte Angebotsrevision und den Preis mit der Bestellung. Wenn sich die Bedingungen vor dem Kauf ändern, zeigen Sie das aktualisierte Angebot zur Annahme an. Wiederkehrende Käufe haben eigene verfügbare Bedingungen und einen eigenen Zeitplan.
Wiederherstellen ohne erneuten Kauf
Speichern Sie einen Idempotency-Key, bevor Sie eine Bestellung erstellen, und verwenden Sie ihn mit derselben Anfrage erneut, wenn die Antwort unterbrochen wird. Wenn Sie die Bestell-ID haben, lesen Sie diese Bestellung zuerst, um festzustellen, ob sie abgeschlossen wurde.
Gehostete Installation
Senden Sie eine Einrichtung, die der Kunde öffnen kann.
Nach Abschluss der Bestellung erstellen Sie einen gehosteten Installationslink oder senden ihn per E-Mail oder SMS. Der Kunde öffnet gerätespezifische Anleitungen, ohne sich in einem Bird-Workspace anzumelden. Verfolgen Sie die Nachrichtenzustellung getrennt von der Installation und der ersten mobilen Datenverbindung.
Installationszugriff kontrollieren
Installationszugangsdaten verwenden separate API-Berechtigungen. Prüfen Sie das Ablaufdatum des gehosteten Links und widerrufen Sie ihn, wenn er die falsche Person erreicht. Das Widerrufen eines Links unterbindet künftigen Zugriff darüber; es deaktiviert kein bereits installiertes Profil.
Paketguthaben lesen
Zeigen Sie gekauftes Volumen, Ablaufdatum und gemeldeten Verbrauch mit dem Beobachtungszeitpunkt an. Wenn der Verbrauch nicht verfügbar ist, lassen Sie ihn als unbekannt, damit Kunden ihr Paketvolumen von einem gemessenen Restguthaben unterscheiden können.
Laufende Käufe
Ermöglichen Sie Kunden, Daten zur selben eSIM hinzuzufügen.
Listen Sie kompatible Angebote für eine bestehende eSIM auf, bevor Sie eine Aufladung anzeigen. Eine abgeschlossene Aufladung fügt dem installierten Profil ein Paket hinzu, sodass der Kunde diese eSIM ohne erneute Installation weiternutzen kann.
Wiederkehrende Pakete planen
Wenn ein Angebot Verlängerung unterstützt, weisen Sie die Person zu, die die eSIM nutzt, und akzeptieren Sie den wiederkehrenden Preis und Rhythmus. Verfolgen Sie Zahlung und Paketbereitstellung jeder Periode und ermöglichen Sie dem Kunden, künftige Verlängerungen zu stoppen.
Kundenzugriff in Ihrer App behalten
Authentifizieren Sie Ihre Kunden und autorisieren Sie den Zugriff auf deren eigene Bestellungen und eSIMs. Ein Workspace-API-Schlüssel kann auf Ressourcen mehrerer Kunden zugreifen – bewahren Sie ihn daher auf Ihrem Server auf und ordnen Sie jede Ressource dem richtigen Konto zu.
Bauen Sie mit der richtigen Referenz
Fragen zur eSIM-API
Was kann ich mit der eSIM-API entwickeln?
Was brauche ich für einen Kauf?
Wie gehe ich mit einer unterbrochenen Kaufantwort um?
Bedeutet eine abgeschlossene Bestellung, dass der Kunde online ist?
Den vollständigen Service verbinden
Skalieren, ohne
die Kontrolle zu verlieren.
Organisieren Sie Teams in Workspaces, steuern Sie den API-Zugriff und verfolgen Sie Änderungen über Audit-Logs.
Audit-Protokoll
Produktion- Workspace
- Produktion
- Ressource
- Zustellagent
- LesezugriffLesen und Schreiben