Jedes Mal, wenn Sie die EMnify-API verwenden möchten, müssen Sie sich authentifizieren. Dafür können Sie entweder Ihre EUI Zugangsdaten (nicht sicher) oder ein Application Token (empfohlen) verwenden.
1. Erstellen Sie ein Application Token auf der EUI;
2. Generieren Sie im Postman ein Authentication Token basierend auf dem Application Token;
3. Verwenden Sie das Authentication Token für alle anderen APIs.
1. Erstellen Sie ein Application Token auf der EUI
- Klicken Sie auf das Symbol
in der rechten oberen Ecke der EUI;
- Klicken Sie auf "Create New Application Token";
- Speichern Sie das Token.
2. Generieren Sie ein Authentication Token basierend auf dem Application Token
2.1 API authenticate
Jetzt, da wir das Application Token haben, können wir damit ein Authentication Token erstellen, das dann zur Ausführung aller anderen APIs verwendet wird.
Um dieses Token zu erstellen, müssen wir die hier beschriebene Post-API-Authentifizierung ausführen. In unserem Beispiel verwenden wir Postman.
API Call
POST https://cdn.emnify.net/api/v1/authenticate
Headers
Content-Type: application/json
Body
{
"application_token":"daDayJhbasaDADGciOiJIUzUxMiJ9.eyJlc2MuYXBwc2VjcmV0IjoiMDgyMmU1MzgtM2NhYi00ZTI1LTlmOTgtZTA2NjU1MzBjYzRkIiwic3ViIjoic3VjY2Vzc0BlbW5pZnkuY29tIiwiYXVkIjoiXC9hcGlcL3YxXC9hcHBsaWNhdGlvbl90b2tlbiIsImVzYy5hcHAiOjczOSNjLnVzZXIiOjE5NDgwMiwiZXNjLm9yZyI6MTU3MiwiZXNjLm9yZ05hbWUiOiJFTW5pZnkgR3Jvd3RoIFRlYW0iLCJpc3MiOiJzcGMtZnJvbnRlbmQxMDFAc3BjLWZyb250ZW5kIiwiZXhwIjoxNjA5NDU1NTk5LCJpYXQiOjE1MTAwNTkyODl9IUHHTbioPOIsZSzar"
}
Response: status 200 OK
{
"auth_token":"UINiILhnHOIoiJIUzUxMiJ9.eyJhdWQiOiJcL2FwaVwvdjFcL2F1dGhlbnRpY2F0aW9uIiwiZXNjLmFwcCI6NzM5LCJlc2MudXNlciI6bnVsbCwiZXNjLm9yZyI6MTU3MiwiZXNjLm9yZ05hbWUiOiJFTW5pZnkgR554554454265FRlYW0iLCJpc3MiOiJzcGMtZnJvbnRlbmQxMDFAc3BjLWZyb250ZW5kIiwiZXhwIjoxNTEwMDczNzUzLCJpYXQiOjE1MTAwNTkzNTN9.nSAMOKzBeu33tS-ihdhuHiUIGFRTyGtTRFvytGF"
}
Im Feld "Response" sehen wir das generierte Authentication Token.
Aus Sicherheitsgründen verfällt das Authentication Token nach 240 Minuten. Daher muss die Authentifizierung erneut durchgeführt werden, um ein neues Authentication Token zu erhalten. Dazu speichern Sie das Request.
2.2 Erstellung einer Variable
Um das Token für jede API zu verwenden, können wir eine Variable erstellen.
In Postman fügen Sie den folgenden Text im "Tests" Tab des Authentication Requests hinzu, um die Variable "Auth_Token" zu kreieren.
Tests:
var jsonData = JSON.parse(responseBody);
postman.setEnvironmentVariable("Auth_Token",jsonData.auth_token)
Sie können die API erneut ausführen, um die Variable zu erstellen.
3. Verwenden Sie den Authentication Token für alle anderen APIs
Da wir uns vor der Verwendung einer anderen API authentifizieren müssen, können wir die neu erstellte Variable verwenden, bevor wir andere Requests aufrufen. Für Demozwecke verwenden wir die hier beschriebene "Endpoint Collection" GET API.
Legen Sie in Postman ein neues Request an.
API Call
GET https://cdn.emnify.net/api/v1/endpoint?page=1&per_page=20&sort=id
Diesmal müssen wir zwei "Headers" anlegen. Der erste Header beschreibt die Art der API, die wir verwenden. Der zweite Header dient der Autorisierung / Authentifizierung.
Headers
Content-Type: application/json
Authorization: Bearer {{Auth_Token}}
Response: status 200 OK
[
{
"id": 1,
"name": "arduino01",
"tags": "arduino, meter, temp",
"created": "2014-08-01T08:47:00+00:00",
"last_updated": "2016-02-29T14:02:47.000+0000",
"status": {
"id": 1,
"description": "Disabled"
},
"service_profile": {
"id": 1,
"name": "Smart Meter"
},
"tariff_profile": {
"id": 3,
"name": "Domestic only"
},
"sim": {
"id": 788,
"iccid": "7368267365454773621",
"imsi": "90199123565690",
"msisdn": "+885637486456"
},
"imei": "8645454889321",
"imei_lock": true,
"ip_address": "10.288.23.75",
"ip_address_space": {
"id": 2
},
]
Sie können nun die EMnify-API-Bibliothek verwenden. Vergessen Sie nicht, das Authentication Token für jeden Ihrer API-Aufrufe zu integrieren.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.