# Obtener token con información extra - gettoken

##### <span class="api-method" data-method="POST">POST</span> https://api.service24gps.com/api/v1/gettoken

Para obtener acceso las aplicaciones y herramientas de los clientes deben solicitar a través del servicio una llave (Token) de autenticación que le permitirá hacer uso de los servicios durante **seis horas continuas**, una vez transcurrido este periodo de tiempo, se debe volver a solicitar otro Token de autenticación.

<details class="mb-m" id="bkmrk-body-parametersparam"><summary class="text-muted">Ver parámetros de solicitud:</summary>

<div><table class="table" style="height: 331px; width: 826px;"><tbody><tr style="height: 41px;"><th style="width: 113px; height: 41px;">Parámetros</th><th style="width: 329px; height: 41px;">Descripción</th><th style="width: 99px;">Longitud</th><th style="width: 285px; height: 41px;">Ejemplo</th></tr><tr style="height: 58px;"><td style="width: 113px; height: 58px;">apikey</td><td style="width: 329px; height: 58px;">Llave de autorización para uso de los Servicios Web.</td><td style="width: 99px;">  
<span style="color: #3366ff;">50</span></td><td style="width: 285px; height: 58px;"><span role="presentation" style="padding-right: 0.1px; color: #3366ff;">25sdsd234234aa93sdsdsd37c70118e72</span></td></tr><tr style="height: 41px;"><td style="width: 113px; height: 41px;">token</td><td style="width: 329px; height: 41px;">Debe ir en blanco como cadena vacía.</td><td style="width: 99px;">  
<span style="color: #3366ff;">500</span></td><td style="width: 285px; height: 41px;"> </td></tr><tr style="height: 75px;"><td style="width: 113px; height: 75px;">username</td><td style="width: 329px; height: 75px;">Un usuario autorizado para usar el servicio por parte del cliente y debe estar definido previamente.</td><td style="width: 99px;">  
<span style="color: #3366ff;">150</span></td><td style="width: 285px; height: 75px;"><span style="color: #3366ff;">usuario</span></td></tr><tr style="height: 41px;"><td style="width: 113px; height: 41px;">password</td><td style="width: 329px; height: 41px;">Contraseña asociada al usuario.</td><td style="width: 99px;">  
<span style="color: #3366ff;">50</span></td><td style="width: 285px; height: 41px;"><span style="color: #3366ff;">contraseña</span></td></tr><tr style="height: 75px;"><td style="width: 113px; height: 75px;">get\_info</td><td style="width: 329px; height: 75px;">Bandera (1 o 0) para obtener además del token el tiempo restante de vida del mismo, información de usuario y cliente.</td><td style="width: 99px;">  
<span style="color: #3366ff;">1</span></td><td style="width: 285px; height: 75px;"><span style="color: #3366ff;">1</span></td></tr></tbody></table>

</div></details>##### Solicitud de ejemplo:

```shell
curl --location --request POST 'https://api.service24gps.com/api/v1/gettoken' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token=""' \
--form 'username="usuario"' \
--form 'password="contraseña"' \
--form 'get_info="1"' \
```

##### Respuesta de ejemplo con "get\_info":

```JSON
{
	"status": 200,
	"data": {
    	"id_user": "11",
      	"id_cli": "12",
      	"name_user": "prueba_user",
      	"name_cli": "FA SA CV",
      	"token": "wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==",
      	"time_left": 190 
    }
}
```

<details class="mb-m" id="bkmrk-ver-par%C3%A1metros%3A-par%C3%A1"><summary class="text-muted">Ver campos de respuesta:</summary>

<div><table class="table" id="bkmrk-campo-descripci%C3%B3n-fo" style="width: 809px; height: 482px;"><tbody><tr style="height: 46px;"><th style="width: 174px; height: 46px;">Campo</th><th style="width: 392px; height: 46px;">Descripción

</th><th style="width: 243px; height: 46px;">Formato</th></tr><tr style="height: 41px;"><td style="width: 174px; height: 41px;">id\_user</td><td style="width: 392px; height: 41px;">Identificador único del usuario en plataforma.</td><td style="width: 243px; height: 41px;">Entero</td></tr><tr style="height: 41px;"><td style="width: 174px; height: 41px;">id\_cli</td><td style="width: 392px; height: 41px;">Identificador único del cliente en plataforma.</td><td style="width: 243px; height: 41px;">Entero</td></tr><tr style="height: 47px;"><td style="width: 174px; height: 47px;">name\_user</td><td style="width: 392px; height: 47px;">Nombre del usuario en plataforma.

</td><td style="width: 243px; height: 47px;">Cadena de Texto</td></tr><tr style="height: 47px;"><td style="width: 174px; height: 47px;">name\_cli

</td><td style="width: 392px; height: 47px;">Nombre del cliente en plataforma.

</td><td style="width: 243px; height: 47px;">Cadena de Texto</td></tr><tr style="height: 35px;"><td style="height: 35px; width: 174px;">token

</td><td style="height: 35px; width: 392px;">Cadena de texto que ayuda a autenticarte.

</td><td style="height: 35px; width: 243px;">Cadena de Texto

</td></tr><tr style="height: 35px;"><td style="height: 35px; width: 174px;">time\_left

</td><td style="height: 35px; width: 392px;">Cantidad de minutos restantes para el uso del token

</td><td style="height: 35px; width: 243px;">Cadena de Texto

</td></tr></tbody></table>

</div></details>