Über die API haben Sie die Möglichkeit, den Status mehrerer SIM Karten gleichzeitig zu ändern (aktivieren oder sperren). Dazu müssen die SIM-Karten zunächst in der EUI registriert werden (Schritt 1). Dann müssen Sie die SIM-ID der SIM Karten herausfinden (Schritt 2). Sie können sie schließlich aktivieren oder sperren (Schritt 3). Durch die Verwendung einer API-Software wie Postman können Sie dies für mehrere SIM Karten gleichzeitig tun (Schritt 4).

Um dieses Artikel zu verstehen, müssen Sie erst wissen, wie man ein Application Token für die API Authentifiezierung verwendet.

1. Registrierung der SIM über ihren BIC

Bevor wir ihren Status ändern können, müssen wir die SIM-Karten registrieren.

Sie können dies über die EUI tun, wie hier beschrieben, oder die folgende API ausführen. Im folgenden Beispiel lautet der BIC ABCD1234EFGH6789

API call:

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

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

Response: 200 OK

2. Herausfinden der SIM-ID der SIM-Karten

Diese Informationen finden Sie in der EUI im Tab "SIMs". Kopieren Sie einfach die ID aller SIM-Karten, deren Status Sie ändern möchten. 

 Sie können auch das Dashboard "SIM database" unter "Stats->Data Analytics" aufrufen und eine .csv-Datei mit allen Daten Ihrer SIM-Karte herunterladen.

3. Aktivierung oder Sperrung einer SIM-Karte anhand ihrer ID

3.1 Statusinfo

Eine SIM-Karte kann 4 verschiedene Status haben:

• 0: " Issued " - Ausgangszustand, nachdem die SIM-Karte auf ein Konto registriert wurde. Dieser Status kann nur auf den Status 1 " activated " aktualisiert werden.
• 1: " Activated" - Die SIM kann nun verwendet werden und die Hosting-Gebühr wird monatlich berechnet. Dieser Status kann auf 2 " suspended ".
• 2: "Suspended" - Die SIM-Karte wurde gesperrt, sie funktioniert nicht mehr und es wird keine monatliche Gebühr erhoben. Sie kann wieder aktiviert werden. Dieser Status kann auf 1 "activated".
• 3: "Deleted" - Die SIM-Karte wurde aus dem System gelöscht. Es kann nicht erneut registriert werden und wird nie wieder funktionieren. Dieser Status ist dauerhaft.

3.2 Ausführen der API

 So sieht die API für eine ausgegebene SIM-Karte mit der ID "231231" aus.

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. Aktivierung oder Sperrung mehrerer SIM-Karten mit Hilfe von Postman  

Wenn Sie den Status mehrerer SIM-Karten gleichzeitig ändern möchten, können Sie eine Compilation in Postman durchführen..

4.1 Erstellung einer CSV-Datei mit der SIM-ID

Sie können Excel verwenden, aber es ist manchmal chaotisch, wenn Sie .csv-Dateien verwenden. Notepad++ kann besser sein.

4.2 Aktualisierung der Patch API

Postman verwendet die Informationen in Ihrer .csv-Datei. Wir müssen die API wie folgt aktualisieren:

 API call:

PATCH https://cdn.emnify.net/api/v1/sim/{{sim-id}}

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 Ausführung einer Sammlung in Postman, um den Status mehrerer SIM-Karten zu ändern

Führen Sie in Postman die Collection mit der obigen API aus. Klicken Sie auf Runner, wählen Sie die richtige Collection und Environment und wählen Sie die .csv-Datei, die Ihre Sim-ID-Informationen enthält. Das Feld " Iteration " sollte die Anzahl der Zeilen innerhalb dieser Datei anzeigen. Sie können eine Vorschau anzeigen, um sicherzustellen, dass das Format passt. Es sollte wie folgt aussehen:

Wenn Sie fertig sind, klicken Sie auf " Run...". Der Status der SIM-Karten sollte aktualisiert werden.