Via API, vous avez la possibilité de changer le statut (activation ou suspension) de plusieurs SIM à la fois. Pour ce faire, les cartes SIM doivent d'abord être enregistrées dans l'EUI (étape 1), vous devez ensuite connaître leur SIM ID (étape 2) et enfin les activer ou les suspendre (étape 3). En utilisant un logiciel API comme Postman, vous pouvez le faire pour plusieurs SIM à la fois (étape 4).

Pour comprendre cet article, il faut être capable de s'authentifier à l'aide d'un "Application Token".

1. Enregistrer la carte SIM (si ce n'est pas déjà fait) en utilisant son BIC.
Avant de pouvoir effectuer des actions sur les cartes SIM, nous devons les enregistrer.

Vous pouvez le faire via l'EUI, comme expliqué ici, ou exécuter l'API suivante. Dans l'exemple ci-dessous, le BIC est ABCD1234EFGH6789.

Requête API :

GET https://cdn.emnify.net/api/v1/sim_batch/bic/ABCD1234EFGH6789

Header:
Content-type: application/json
Authorization: Bearer {{auth_token}}

Response: 200 OK

2. Trouvez le SIM ID de vos cartes SIM
Ces informations se trouvent dans l'EUI dans l'onglet "SIMs". Copiez et collez simplement l'ID de toutes les cartes SIM dont vous voulez changer le statut. 

3. Activez ou suspendez une carte SIM en fonction de son ID

3.1 Information concernant les Status : 

Une SIM peut avoir 4 differents statuts : 

• 0 : "Issued" - état initial après l'enregistrement de la carte SIM sur un compte. Ce statut ne peut être mis à jour qu'avec le statut 1 "activé".

• 1 : "Activated" - La carte SIM peut maintenant être utilisée et les frais par SIM active seront facturés chaque mois. Cet état peut être mis à jour à 2 "suspended".

• 2 : "Suspended" - La carte SIM a été suspendue, elle ne peut accrocher le réseau mobile et aucun frais mensuel ne sera facturé. La SIM peut être activé à nouveau. Cet état peut être mis à jour à 1 "activated".

• 3 : "Deleted" - La carte SIM a été effacée du système. Elle ne peut pas être réenregistrée et ne fonctionnera plus jamais. Ce statut est permanent. 

3.2 Envoyer des requêtes API 

Veuillez trouver ci-dessous la requête API pour activer ou suspendre une SIM avec le SIM ID "231231".

API call:

PATCH https://cdn.emnify.net/api/v1/sim/231231

Header:
Content-type: application/json
Authorization: Bearer {{auth_token}}

Body: 

{
"status": {
"id": 1
}
}

4. Activer ou suspendre plusieurs SIM dans Postman  

Si vous souhaitez changer le statut de plusieurs cartes SIM en une fois, vous pouvez executer une compilation dans Postman. 

4.1 Creer un fichier .CSV avec le SIM ID 

Vous pouvez utiliser excel, cependant il se peut que le format soit modifié et inutilisable. Nous recommandons d'utiliser Notepadd++.

4.2 Mettre à jour le statut de la carte SIM grâce à PATCH API 

Postman utilise les information contenues dans le fichier .csv. Pour mettre à jour la carte SIM, il nous faut utiliser la requête API suivante : 

requête API :

PATCH https://cdn.emnify.net/api/v1/sim/231231

Header:
Content-type: application/json
Authorization: Bearer {{auth_token}}

Body: 

{
"status": {
"id": 1
}
}

Pre-request Script:
console.log("sim-id" + data.sim-id)

 4.3 Exécuter une collection dans Postman pour changer le statut de plusieurs cartes SIM : 

Dans Postman, exécutez la collection contenant l'API ci-dessous. Cliquez sur "Runner", choisissez la bonne collection et environnement et selectionnez le fichier .csv contenant les information sur le SIM ID. Le champs "iterations" devrait être mis à jour et montrer le nombre de ligne contenu dans le fichier. Vous pouvez prévisualiser le fichier et vérifier que le format est le bon. Le format devrait être le suivant : 

Lorsque vous êtes prêt, cliquez sur "Run...". Le statut de la SIM devrait être mis à jour.