Intégration API
Cet article explique quelles APIs je dois intégrer pour la gestion de l’offre MVNO France Full.
Nous détaillerons les méthodes API nécessaires, avec des liens vers le Transatel Developer Portal, qui détient tous les références API.
Pour pouvoir vous lancer sur votre MVNO France Full, d’abord vous devez vous authentiquer aux API de Transatel en obtenant des access tokens, grâce à notre Authentication API.
Les access tokens sont obtenus en envoyant une requête avec votre nom d’utilisateur et mot de passe qui vous ont été transmis par votre Chef de Projet, lors de la phase de lancement de votre compte.
Une fois cette étape franchie, vous pourrez dès à présent intégrer plusieurs API de Transatel. Veuillez contacter votre gestionnaire de compte pour confirmer les options auxquelles vous avez souscrit.
1. L’API Connectivity Management :
Vous devez intégrer cette API, entre autre, pour activer, suspendre ou terminer vos SIMs ou eSIMs. Elle comprend les informations suivantes qui pourront vous intéresser :
– Gestion de l’abonné : gérez le cycle de vie d’un abonné et modifier son plan tarifaire ou ses options.
Cette fonctionnalité comprend :
Informations sur la SIM : récupérez des informations sur une SIM, par exemple l’information concernant la portabilité
Gestion des informations de contacts : mettez à jour l’information concernant les coordonnées de contact de l’abonné
Informations de transactions : récupérez l’information concernant une transaction
– Gestion de portabilité : gérez les numéro de vos abonnés finaux
– Gestion des évènements : générez des évènements liées au cycle de vie de vos abonnés et à leur portabilité.
Un évènement signifie, par exemple, lorsque la SIM d’un abonné est échangée avec une autre SIM (SIM swap), ou le numéro (MSISDN) d’un abonné est échangé avec un autre numéro.
Ils peuvent ensuite être transmis à votre plateforme en créant des webhooks, en utilisant notre Webhook API, qui vous permettront d’envoyer des notifications à l’utilisateur final ou de faciliter votre flux de travail.
2. L’API SIM Management :
Cette API est utilisée pour les informations liées à vos eSIM, dès qu’elles sont en état Active (que vous aurez fait préalablement grâce à l’API Connectivity Management).
L’endpoint ‘Get eSIM details‘ vous permet d’avoir toutes les informations nécessaires pour gérer les profiles eSIM et consulter leur statut. Elle vous permettra par exemple de reçevoir le code d’Activation pour que votre abonné puisse télécharger un profil.
ATTENTION : le code d’Activation de votre eSIM ne peut être téléchargée qu’une seule fois. Votre abonné doit s’assurer d’être dans un environnement avec une connexion wifi fiable. Après installation, l’abonné pourra désactiver le wifi et dès à présent utiliser la data, voix et SMS de l’eSIM.
Pour utiliser l’endpoint ‘Release a given eSIM profile’, veuillez contacter votre gestionnaire de compte.
L’endpoint ‘Reserve an eSIM profile’ n’est actuellement pas disponible pour votre offre.
3. L’API Online Charging System (OCS) :
Elle vous permet de gérer et contrôler les usages de vos SIMs en temps réel, par exemple avec les forfaits roaming journaliers.
Cette API est a utilisé si vous avez souscrit à l’option Blocage Data en Temps-réel.
4. L’API Network, qui inclut :
– Network attach : obtenez l’historique des mises à jour de la localisation et la possibilité de déclencher une déconnexion du réseau (network detach).
– Data session : accédez aux informations sur la session de données active de vos cartes SIM.
– SMS-A2P : envoyez des SMS sur le réseau à vos abonnés, par exemple pour les informer d’une offre promotionnelle.
Toutes les offres de Transatel peuvent être gérées via notre plateforme de gestion SIM. Cependant, il se peut que vous voudriez connecter vos SIM MVNO à vos propres systèmes (ou à votre BSS).
Ceci est possible en intégrant nos API et vous permettra de :
– centraliser toutes vos interfaces internes en un seul endroit et à l’aide d’un outil unique
– automatiser des actions et des processus, comme l’envoi automatique d’un SMS à l’utilisateur final