Intégration API

Quels APIs et interfaces dois-je intégrer ?


Cet article explique quelles APIs je dois intégrer pour la gestion de l’offre MVNO France Light.
Nous détaillerons les méthodes API nécessaires, avec des liens vers le Transatel Developer Portal, qui détient toutes les références API.

Comment intégrer les API de Transatel ?


Pour pouvoir vous lancer sur votre MVNO France Light, 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 notre Connectivity Management API.

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.

Le portail développeur fournit aussi de multiples guides pour l’API Connectivity Management, qui vous aiderons à lancer votre MVNO. Par exemple, vous pourrez trouver un guide détaillé sur
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.l’activation d’un abonné ou le port d’un numéro.

Si vous avez des questions, n’hésitez pas à contacter votre gestionnaire de compte.

Pourquoi choisir d’intégrer des APIs ?


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

Besoin d'assistance ?