HarborOrganisationEspaces de travailProductionBac à sable
Agent d’envoi
Clé API · Équipe Opérations clientsALAlex Lee AdministrateurAutorisations mises à jour
Intégrez les données mobiles dans votre application.
Utilisez l'API eSIM pour découvrir les offres data, acheter des forfaits et envoyer des liens d'installation privés depuis votre application. Gardez les clients dans votre propre expérience de compte pour les soldes signalés, les recharges compatibles et les achats récurrents lorsque disponibles.
Commencez par les offres disponibles.
Utilisez une clé API côté serveur avec la permission de lecture eSIM pour explorer le catalogue. Cet exemple liste les offres sans acheter de forfait.
1
bird esim offers listDe l'offre à la commande
Transformez une offre en achat récupérable.
Consultez la couverture, le volume et la validité de l'offre, puis obtenez son prix de paiement actuel. Le portefeuille de votre organisation finance l'achat. Sauvegardez la commande résultante pour que le client puisse y revenir pendant que Bird provisionne l'eSIM et le forfait data.
Présentez les conditions acceptées
Envoyez la révision d'offre et le prix acceptés avec la commande. Si les conditions changent avant l'achat, affichez le devis mis à jour pour acceptation. Les achats récurrents ont leurs propres conditions et calendrier disponibles.
Récupérez sans nouvel achat
Sauvegardez une clé d'idempotence avant de créer une commande et réutilisez-la avec la même requête si la réponse est interrompue. Si vous avez l'ID de la commande, lisez d'abord cette commande pour savoir si elle a abouti.
Installation hébergée
Envoyez une configuration que le client peut ouvrir.
Une fois la commande terminée, créez un lien d'installation hébergé ou envoyez-le par e-mail ou par SMS. Le client ouvre des instructions spécifiques à l'appareil sans se connecter à un espace de travail Bird. Suivez la livraison du message séparément de l'installation et de la première connexion aux données mobiles.
Contrôlez l'accès à l'installation
Les identifiants d'installation utilisent des permissions API distinctes. Vérifiez l'expiration du lien hébergé et révoquez-le s'il parvient à la mauvaise personne. Révoquer un lien empêche tout accès futur par ce lien ; cela ne désactive pas un profil déjà installé.
Consultez les soldes des forfaits
Affichez le volume acheté, l'expiration et la consommation signalée avec son heure d'observation. Lorsque l'utilisation n'est pas disponible, gardez-la inconnue pour que les clients puissent distinguer le volume de leur forfait d'un solde restant mesuré.
Achats continus
Permettez aux clients d'ajouter des données à la même eSIM.
Listez les offres compatibles pour une eSIM existante avant de proposer une recharge. Une recharge complétée ajoute un forfait au profil installé, de sorte que le client peut continuer à utiliser cette eSIM sans nouvelle installation.
Planifiez des forfaits récurrents
Lorsqu'une offre prend en charge le renouvellement, associez la personne utilisant l'eSIM et acceptez son prix récurrent et sa cadence. Suivez le paiement et la livraison du forfait à chaque période, et laissez le client arrêter le renouvellement futur.
Gardez l'accès client dans votre application
Authentifiez vos clients et autorisez l'accès à leurs propres commandes et eSIM. Une clé API d'espace de travail peut accéder aux ressources de plusieurs clients : conservez-la sur votre serveur et associez chaque ressource au bon compte.
Construisez avec la bonne référence
Questions sur l'API eSIM
Que puis-je construire avec l'API eSIM ?
Intégrez la découverte d'offres, l'achat de forfaits data, la livraison d'installation et la gestion continue des forfaits dans votre application. Les clients peuvent acheter des recharges compatibles et souscrire à des achats récurrents lorsque disponibles. Votre application gère l'authentification des clients et tout paiement qu'elle perçoit auprès d'eux.
De quoi ai-je besoin pour effectuer un achat ?
Utilisez un espace de travail Bird, une clé API côté serveur avec les permissions eSIM requises et des fonds dans le portefeuille de l'organisation. Consultez l'offre, les conditions de paiement et les exigences d'identification avant d'acheter. La lecture des identifiants et la création ou l'envoi de liens d'installation nécessitent des permissions d'identifiants distinctes.
Comment gérer une réponse d'achat interrompue ?
Lisez la commande existante si vous avez son ID. Sinon, renvoyez la requête de création sauvegardée avec sa clé d'idempotence d'origine. Suivez cette commande jusqu'à son aboutissement ou son échec avant d'en créer une nouvelle qui pourrait entraîner une facturation supplémentaire.
Une commande complétée signifie-t-elle que le client est en ligne ?
Une commande complétée identifie l'eSIM et le forfait achetés. Le client doit encore installer le profil sur un appareil compatible et tester les données mobiles dans une destination couverte. Les rapports d'installation et de solde peuvent arriver après le résultat de l'appareil.
Connectez le service complet
Installation eSIMAidez vos clients à installer sur leur appareil et à se connecter grâce à des instructions claires.Consommation et rechargesAffichez l'enveloppe et l'expiration, puis proposez des données supplémentaires compatibles.Opérations de connectivitéRésolvez les problèmes d'achat, d'installation et de forfait avec les enregistrements de service existants.Bibliothèque de ressources eSIMParcourez les guides pratiques, les réponses détaillées et les références techniques.
Évoluez sans
perdre le contrôle.
Organisez vos équipes en espaces de travail, contrôlez l'accès à l'API et tracez les modifications via les journaux d'audit.
HarborOrganisationActif
Journal d'audit
Production- Espace de travail
- Production
- Ressource
- Agent d’envoi
- Accès en lectureLecture et écriture
Équipe Opérations clientsRôle de l’acteur AdministrateurRésultat RéussiHeure 22 sept., 09:42:18 UTC
Réussi