Chaque fois que vous voulez utiliser l'API EMnify, vous devez vous authentifier. Vous pouvez le faire avec vos identifiants EMnify ou avec un Jeton d'application plus sécurisé. Voici les étapes :
1. Créez un jeton d'application sur l'EUI ;
2. Générer un jeton d'authentification basé sur le jeton d'application ;
3. Utiliser le jeton d'authentification pour toutes les autres API.
1. Créer un jeton d'application sur l'interface utilisateur d'EMnify.
- Cliquez sur ce symbole
dans le coin droit de l'EUI.
- Sélectionnez "Create New Application Token"
- Sauvegardez le jeton d'application dans un endroit sûr.
2. Générer un jeton d'authentification à partir de Postman
Vous pouvez utiliser le jeton d'application pour créer un jeton d'authentification dans Postman, que vous utiliserez ensuite pour exécuter les API EMnify comme expliqué ici.
Une fois le jeton d'application créé, vous pouvez l'utiliser pour générer un jeton d'authentification. Connectez-vous à Postman, copiez le jeton d'application comme ci-dessous et envoyez la requête API suivante. Elle créera un jeton d'application visible dans le corps de la réponse.
Pour automatiser l'authentification, vous devrez créer une variable avec le jeton d'authentification à partir du corps de la réponse. Une nouvelle variable appelée : "Auth_Token" sera créée.
Requête API
POST https://cdn.emnify.net/api/v1/authenticate
Headers
Content-Type: application/json
Body
{
"application_token":"daDayJhbasaDADGciOiJIUzUxMiJ9.eyJlc2MuYXBwc2VjcmV0IjoiMDgyMmU1MzgtM2NhYi00ZTI1LTlmOTgtZTA2NjU1MzBjYzRkIiwic3ViIjoic3VjY2Vzc0BlbW5pZnkuY29tIiwiYXVkIjoiXC9hcGlcL3YxXC9hcHBsaWNhdGlvbl90b2tlbiIsImVzYy5hcHAiOjczOSNjLnVzZXIiOjE5NDgwMiwiZXNjLm9yZyI6MTU3MiwiZXNjLm9yZ05hbWUiOiJFTW5pZnkgR3Jvd3RoIFRlYW0iLCJpc3MiOiJzcGMtZnJvbnRlbmQxMDFAc3BjLWZyb250ZW5kIiwiZXhwIjoxNjA5NDU1NTk5LCJpYXQiOjE1MTAwNTkyODl9IUHHTbioPOIsZSzar"
}
Tests:
var jsonData = JSON.parse(responseBody);
postman.setEnvironmentVariable("Auth_Token",jsonData.auth_token)
Response: status 200 OK
{
"auth_token":"UINiILhnHOIoiJIUzUxMiJ9.eyJhdWQiOiJcL2FwaVwvdjFcL2F1dGhlbnRpY2F0aW9uIiwiZXNjLmFwcCI6NzM5LCJlc2MudXNlciI6bnVsbCwiZXNjLm9yZyI6MTU3MiwiZXNjLm9yZ05hbWUiOiJFTW5pZnkgR554554454265FRlYW0iLCJpc3MiOiJzcGMtZnJvbnRlbmQxMDFAc3BjLWZyb250ZW5kIiwiZXhwIjoxNTEwMDczNzUzLCJpYXQiOjE1MTAwNTkzNTN9.nSAMOKzBeu33tS-ihdhuHiUIGFRTyGtTRFvytGF"
}
Note : N'oubliez pas d'enregistrer cette demande afin de rafraîchir le jeton d'authentification pour les connexions suivantes.
3. Utilisez le jeton d'authentification pour les requêtes API suivantes
A des fins de démonstration, nous intégrerons le jeton d'authentification dans la requête API pour obtenir la liste des endpoints (GET Endpoint collection). Les étapes seront les suivantes:
- Envoyer l'API d'authentification avec le jeton d'application pour rafraîchir le jeton d'authentification (cf. ci-dessus).
- Envoyez la requête API suivante pour récupérer la collection des endpoints avec le Auth_token.
API Call
GET https://cdn.emnify.net/api/v1/endpoint?page=1&per_page=20&sort=id
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
},
]
A partir de maintenant, vous pouvez utiliser la bibliothèque de l'API EMnify. N'oubliez pas d'intégrer le token d'authentification pour chacun de vos requêtes API.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.