Usando la API, tiene la posibilidad de cambiar el estado (activada o suspendida) de múltiples SIMs al mismo tiempo. Para hacerlo, primero la tarjeta SIM debe estar registrada en la EUI (paso 1), luego necesita saber el ID de la SIM (paso 2) y finalmente puede activarla o suspenderla (paso 3). Al usar un software API como Postman, puede hacerlo para varias SIMs de una sola vez (paso 4).
Para entender este artículo, tiene que ser capaz de autenticarse usando un "Application Token".
1. Registre la SIM (Si no esta registrada) usado su código BIC
Antes de poder hacer cualquier acción en la tarjeta SIM, tenemos que registrarlas.
Puede hacerlo a través de la EUI , como se explica aquí, o corriendo la siguiente llamada API. En el ejemplo de abajo, el código BIC es ABCD1234EFGH6789
llamada 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. Encuentre el ID de su tarjeta SIM
Esta información puede ser encontrada en laEUI en la pestaña "SIMs". Simplemente copie y pegue el ID de todas las tarjetas SIM cuyo estado quiera cambiar.
3. Active o suspenda una tarjeta SIM basado en su ID
3.1 Información de estado
Una tarjeta SIM tiene 4 estados diferentes:
- 0: "Issued" - Estado inicial después que la SIM ha sido registrada en una cuenta. Este estado solo puede ser actualizado al estado 1 "activated".
- 1: "Activated" - La SIM puede ser usada y una cuota de mantenimiento mensual será cobrada. Este estado puede ser cambiado a 2 "suspended" y 3 "deleted".
- 2: "Suspended" - Esta SIM ha sido suspendida, no funcionará más y no se seguirá cobrando la couta de mantenimiento. Puede ser reactivada nuevamente. Este estado puede ser cambiado a 1 "activated" y 3 "deleted".
- 3: "Deleted" - Esta SIM ha sido eliminada del sistema. No podrá ser registrada otra vez y no funcionará nunca. Este estado es permanente.
3.2 Corriendo la API
Así es como se ve la llamada API para una SIM registrada con el ID "231231".
Llamada API:
PATCH https://cdn.emnify.net/api/v1/sim/231231
Header:
Content-type: application/json
Authorization: Bearer {{auth_token}}
Body:
|
4. Active o suspenda múltiples tarjetas SIM en Postman
Si desea cambiar el estado de varias tarjetas SIMs al mismo tiempo, Puede correr una compilación en Postman.
4.1 Cree un archivo CSV con los ID de las SIMs
sim-id |
234790 |
234791 |
234792 |
234793 |
Puede usar excel pero algunas veces es un poco desordenado cuando se usa archivos .csv. Notepad++ puede ser mejor.
4.2 Actualice su Patch API
Postman usará la información de su archivo .csv. Tenemos que actualizarlo de la siguiente manera:
Llamada API:
PATCH https://cdn.emnify.net/api/v1/sim/{{sim-id}}
Header:
Content-type: application/json
Authorization: Bearer {{auth_token}}
Body:
|
Pre-request Script:
console.log("sim-id" + data.sim-id)
4.3 Ejecute una colección en Postman para cambiar el estado de varias tarjetas SIM.
En Postman, ejecute la colección que contiene la llamada API descrita arriba. Haga clic en Runner, seleccione la colección y en ambiente correcto y seleccione el archivo .csv que contiene la información de los ID de las SIMs. Las "Iteraciones" debería ser actualizado y debería mostrar el número de filas en el archivo. Puede hacer una vista previa del archivo para asegurarse que el formato está correcto. Debería lucir de la siguiente forma:
Cuando esté listo, haga clic en "Run...". El estado de las tarjetas SIM debería ser actualizado.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.