API eSIM

Construisez la connexion complète.

Intégrez la connectivité dans votre application à travers un modèle de service unique. Reliez le catalogue à un achat autorisé, suivez le provisionnement et l'installation, puis aidez vos clients à gérer le service qu'ils ont acheté. Gardez le contrôle du parcours dans votre expérience client.

Explorer la plateforme eSIM

Une intégration que vous pouvez suivre

EXEMPLE

BIRD · CONNECTIVITÉ

Un seul service. Des enregistrements connectés.

1

Découvrir et sélectionner

Consultez la couverture, les conditions, le prix et l'éligibilité.

2

Acheter et livrer

Suivez une commande acceptée jusqu'à son résultat.

3

Installer et utiliser

Résolvez la configuration privée et observez la première utilisation.

Flux d'intégration illustratif. Suivez le contrat API en vigueur pour les opérations prises en charge et le comportement de reprise.

Commencez par le contrat

Modélisez le service que votre client achète.

Un profil identifie l'eSIM, un forfait décrit une enveloppe de données et une commande enregistre l'achat. Un abonnement récurrent ajoute des périodes de facturation et un service continu. Connectez ces identités dans votre application sans fusionner leurs états distincts.

Lisez avant d'écrire

Découvrez les offres et les capacités effectives pour le client visé. Utilisez les tarifs publiés et l'éligibilité en cours plutôt que de maintenir un catalogue en dur dans l'application.

Conservez l'intention acceptée

Préservez l'offre sélectionnée et l'identité de la requête tout au long de l'achat. Reprenez la commande existante après une réponse incertaine, afin que la reprise ne devienne pas un deuxième débit accidentel.

Construisez un parcours complet

Reliez l'achat à un appareil fonctionnel.

Suivez la commande à travers l'acceptation financière et le provisionnement, puis fournissez un chemin d'installation privé. Remontez le résultat réel à chaque étape au lieu d'indiquer le client comme connecté dès la fin du paiement.

Gardez les identifiants privés

Résolvez les identifiants d'installation via l'expérience client autorisée. Excluez-les de la télémétrie, du Markdown public, des rapports d'incidents et des messages de support général.

Réagissez à l'état observé

Utilisez les événements et les lectures prises en charge pour le service. Conservez les horodatages d'observation, gérez explicitement les informations manquantes et laissez votre interface reprendre à partir de l'état qu'elle reçoit réellement.

Exploitez l'intégration

Intégrez la reprise dans l'implémentation.

Testez un achat contrôlé, une installation et une première utilisation, puis une opération interrompue ou refusée. Utilisez les mêmes identités de service pour relier le support, les relevés financiers et les changements de cycle de vie.

Travaillez avec votre agent de code

Fournissez à l'agent la description API actuelle et le guide de tâche correspondant. Demandez-lui de cartographier les opérations prises en charge, d'implémenter le flux autorisé et de fournir la preuve du résultat client obtenu.

Portez l'acquisition tout au long du parcours

Conservez les identifiants de campagne avec l'acquisition et le transfert client. Reliez-les à la conversion métier enregistrée dans votre application ; passer un paramètre de requête n'est qu'une partie de l'attribution.

Questions sur l'API eSIM

L'API eSIM est-elle uniquement un point de terminaison de code d'installation ?
Non. Une intégration utile couvre aussi la découverte d'offres, l'achat, la livraison, l'état du service et la gestion continue. Les identifiants d'installation ne sont qu'une partie privée de ce cycle de vie.
Un agent de programmation peut-il construire l'intégration ?
Un agent peut s'appuyer sur la description actuelle de l'API, les guides de tâches et votre application. Demandez-lui d'inspecter les opérations prises en charge et de démontrer un parcours complet et maîtrisé ; ne présumez pas qu'une méthode existe à partir d'un exemple marketing.
Comment gérer une réponse d'achat incertaine ?
Conservez la requête d'origine et l'identifiant de commande, puis utilisez le comportement de reprise documenté pour en déterminer le résultat. Lancer un nouvel achat peut entraîner un débit ou un service supplémentaire.
Que faut-il inclure dans la mesure de conversion ?
Enregistrez le résultat métier que vous souhaitez optimiser, comme un achat finalisé ou une première utilisation vérifiée. Conservez le contexte d'acquisition à travers le point de transfert concerné et associez-le à ce résultat sans inclure d'identifiants d'installation privés.

Mettez-le en pratique.

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Obtenir un guide d'implémentation

Commencez par un parcours d'intégration complet.

Associez les opérations de catalogue, d'achat et d'installation prises en charge à votre application. Testez la reprise sur erreur avec la même commande avant d'étendre l'intégration.

Commencez avec un seul canal.
Ajoutez les autres quand vous êtes prêt.

Une clé API de test est disponible immédiatement. L'accès production se débloque dès que vous ajoutez un moyen de paiement et vérifiez un expéditeur.

Vous utilisez Claude Code, Cursor ou Codex ? Copiez un prompt de configuration et votre agent installe la CLI Bird et les compétences pour vous. Choisissez le vôtre :

Cursor