Autenticación

Antes que tu aplicación pueda realizar llamadas al API de Geo Fleet, la aplicación necesita obtener un token de seguridad para acceder.

1 ) Obtener un token

El API de Geo Fleet requiere de un token de seguridad para funcionar. Los tokens son únicos por cada sesión y tienen una expiración.

Para obtener un token se debe realizar una llamada HTTP POST al siguiente servicio:

POST api.geo-track.com/authentication/token

El Content-Type debe ser: application/x-www-form-urlencoded

Parámetros

grant_type
(requerido)
El valor para este flujo debe ser passwordValor:
password
username
(requerido)
Correo electrónico del usuario de Geo FleetValor de ejemplo:
demo@location-world.com
password
(requerido)
El password del usuario.Valor de ejemplo:
abc123
skin
(requerido)
El valor para este flujo debe ser geofleetValor:
geofleet

Respuesta

Respuesta correcta (ejemplo):

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJVc2VySWQiOiIyOTQ5IiwiaXNzIjoibWUiLCJhdWQiOiJldmVyeW9uZSIsImV4cCI6MTQ0NzY5NjkzNSwibmJmIjoxNDQ3Njk2NjM1fQ.vm4CENQKxWdDMtK6UPp1qco1mjo7ZGvH1I2coHis7o0",
  "token_type": "bearer",
  "expires_in": 299,
  "refresh_token": "RAB_Zee0RKAv_yBTk-jBtWUUZf1XslA-Te3Ksj7YDavudJnBdLdtms6Mj_Mb3ONXr8wolWSZysgoq-uEzz0ajK_Qnqk6knndrXe_BcdvyTeGiMSyQ27W3ufySMwWIvgDI6s9QWLRrWeeyHf1Qg213Xy6pWasU-8yV7VQUUkaHKGrWPQbsOAusssTKS3hnvEAoKpGP4OqVTgFMeOMAgZDl1kthi-wH_aMUI5FQx-vWvYp032moJFdqfohe7EtNR43jmb2-hd7UZwUmiW3Nixpl2HPfJKEyA6VIdZieDhPTBg"
}

Respuesta incorrecta, en caso de credenciales no válidas:

{
    "error": "Invalid Login",
    "error_description": "Invalid Credentials"
}

2 ) Actualizar un token

Los tokens del API de Geo Fleet tienen un tiempo de expiración.

Para actualizar el token se debe realizar una llamada HTTP POST al siguiente servicio:

POST api.geo-track.com/authentication/token

El Content-Type debe ser: application/x-www-form-urlencoded

Parámetros

grant_type
(requerido)
El valor para este flujo debe ser refresh_tokenValor:
refresh_token
refresh_token
(requerido)
El token de actualización obtenido en el método de obtención de tokenValor de ejemplo:
RAB_Zee0RKAv_yBTk-jBtWUUZf1XslA-Te3Ksj7YDavudJnBdLdtms6Mj_Mb3ONXr8wolWSZysgoq-uEzz0ajK_Qnqk6knndrXe_BcdvyTeGiMSyQ27W3ufySMwWIvgDI6s9QWLRrWeeyHf1Qg213Xy6pWasU-8yV7VQUUkaHKGrWPQbsOAusssTKS3hnvEAoKpGP4OqVTgFMeOMAgZDl1kthi-wH_aMUI5FQx-vWvYp032moJFdqfohe7EtNR43jmb2-hd7UZwUmiW3Nixpl2HPfJKEyA6VIdZieDhPTBg

Respuesta

Respuesta de ejemplo:

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJVc2VySWQiOiIyOTQ5IiwiaXNzIjoibWUiLCJhdWQiOiJldmVyeW9uZSIsImV4cCI6MTQ0NzY5OTk4MiwibmJmIjoxNDQ3Njk5NjgyfQ.ZL_tn-rRuc0D_JFEDxyRS67pQS_ugDIEjRjoBIzsg04",
  "token_type": "bearer",
  "expires_in": 299,
  "refresh_token": "UsiDX3xFVlaEHjr5dR7i6rVMqDF1Djyx2bOy8TniIFf3aAggsNgGfc8kHcin7ut0hvDVsCEzAhzlPkJnSi-fxPnxYnCQFhP-JjQQAeK5QSBswaW4_izeYW-vnR2y-QW0gOQ4TvB_VYZ8qyG-azK-hgaLP97GwA2ncOPO3j3ZYkaQoKPIgyFbGKJZ61W3tyi-Mrm2AuiZt0bLafK7Jkmj2aospr1x6OHjYsWnM4MJ_WpnV76gYr7pL3lb4NJPXkZI0Hh5Fp-sA5m26QeRu1YhhIKRMgIY1fjy5EAHVPpiCow"
}

Respuesta incorrecta, en caso de credenciales no válidas:

{
    "error": "Invalid Login",
    "error_description": "Invalid Credentials"
}

3 ) Cómo usar el token?

Para utilizar el token, se debe incluir el mismo en el header de la llamada al API.

Para pruebas, se ha desarrollado el siguiente método GET

GET api.geo-track.com/geofleet/devices/hello?name=prueba
Authorization
(requerido)
Se debe enviar la palabra “Bearer” seguido de un espacio y después el valor del tokenValor:
Bearer RAB_Zee0RKAv_yBTk-jBtWUUZf1XslA-Te3Ksj7YDavudJnBdLdtms6Mj_Mb3ONXr8wolWSZysgoq-uEzz0ajK_Qnqk6knndrXe_BcdvyTeGiMSyQ27W3ufySMwWIvgDI6s9QWLRrWeeyHf1Qg213Xy6pWasU-8yV7VQUUkaHKGrWPQbsOAusssTKS3hnvEAoKpGP4OqVTgFMeOMAgZDl1kthi-wH_aMUI5FQx-vWvYp032moJFdqfohe7EtNR43jmb2-hd7UZwUmiW3Nixpl2HPfJKEyA6VIdZieDhPTBg

Respuesta

Respuesta de ejemplo:

{
  "value": "Hello prueba",
  "error": null,
  "requestStatus": 1
}
AtributoDescripción
valueRespuesta de la prueba
error
requestStatusEstado del request

Valores posibles:
1 (OK)
2 (No Authorized)
3 (Expired)
Facebook Comments

Was this article helpful?

Leave A Comment?

You must be logged in to post a comment.