# Plataformas

Administra plataformas

# Crear / actualizar una plataforma - setPlatform

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

Crea o actualiza una plataforma. **NOTA: Una vez que se crea o actualiza, para verse reflejados los cambios se tiene que esperar alrededor de 5 minutos, ya que se maneja una cache.**

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

<div><table class="table" style="height: 98px;"><tbody><tr style="height: 57px;"><td style="width: 188px; height: 57px;">apikey</td><td style="width: 320px; height: 57px;">Llave de autorización para uso de los Servicios Web.</td><td style="width: 301px; height: 57px;"><span role="presentation" style="padding-right: 0.1px; color: #3366ff;">25sdsd234234aa93sdsdsd37c70118e72</span></td></tr><tr style="height: 41px;"><td style="width: 188px; height: 41px;">token</td><td style="width: 320px; height: 41px;">Token devuelto por el método getToken.</td><td style="width: 301px; height: 41px;"><span style="color: #3366ff;">wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==</span></td></tr><tr><td style="width: 188px;">nombre</td><td style="width: 320px;">Nombre para la plataforma</td><td style="width: 301px;"><span style="color: #3366ff;">My Platform</span></td></tr><tr><td style="width: 188px;">url</td><td style="width: 320px;">Url de redireccionamiento para la plataforma</td><td style="width: 301px;"><span style="color: #3366ff;">https://sitio.com/my\_platform</span></td></tr><tr><td style="width: 188px;">icono</td><td style="width: 320px;">Campo opcional, detalle visual para la plataforma (.svg, .png); en caso de no proporcionarse se toma uno por defecto.</td><td style="width: 301px;"><span style="color: #3366ff;">https://sitio.com/my\_icon.svg</span></td></tr><tr><td style="width: 188px;">estado</td><td style="width: 320px;">Campo opcional, bandera para activar (1) o desactivar (0) la plataforma. Si no se proporciona por defecto es 1.</td><td style="width: 301px;"><span style="color: #3366ff;">1</span></td></tr><tr><td style="width: 188px;">id</td><td style="width: 320px;">Campo opcional, sólo se manda el identificador único cuando se va actualizar</td><td style="width: 301px;"><span style="color: #3366ff;">11</span></td></tr></tbody></table>

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

```shell
curl --location --request POST 'https://api.service24gps.com/api/v1/setPlatform' \
--header 'Cookie: PHPSESSID=0ab8djc97ouk13tev2t9epf1l2' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'nombre="My platform"' \
--form 'url="https://sitio.com/my_platform"' \
--form 'icono="https://sitio.com/my_icon.svg"' \
--form 'estado="1"' \
--form 'id="11"'
```

##### Respuesta de ejemplo:

```JSON
{
    "status": 200,
    "data": {
    	"id": "11",
    }
}
```

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

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

</th><th style="width: 243px; height: 47px;">Formato</th></tr><tr style="height: 41px;"><td style="width: 174px; height: 41px;">id</td><td style="width: 392px;" width="351">Identificador único de la plataforma.

</td><td style="width: 243px; height: 41px;">Entero</td></tr></tbody></table>

</div></details>

# Obtener plataformas - getPlatforms

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

Obtiene el listado de plataformas disponibles que se hayan dado de alta anteriormente. **NOTA: Una vez que se crea o actualiza, para verse reflejados los cambios se tiene que esperar alrededor de 5 minutos, ya que se maneja una cache.**

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

<div><table class="table" style="height: 269px;"><tbody><tr style="height: 57px;"><td style="width: 188px; height: 57px;">apikey</td><td style="width: 320px; height: 57px;">Llave de autorización para uso de los Servicios Web.</td><td style="width: 301px; height: 57px;"><span role="presentation" style="padding-right: 0.1px; color: #3366ff;">25sdsd234234aa93sdsdsd37c70118e72</span></td></tr><tr style="height: 41px;"><td style="width: 188px; height: 41px;">token</td><td style="width: 320px; height: 41px;">Token devuelto por el método getToken.</td><td style="width: 301px; height: 41px;"><span style="color: #3366ff;">wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==</span></td></tr></tbody></table>

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

```shell
curl --location --request POST 'https://api.service24gps.com/api/v1/getPlatforms' \
--header 'Cookie: PHPSESSID=0ab8djc97ouk13tev2t9epf1l2' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'
```

##### Respuesta de ejemplo:

```JSON
{
    "status": 200,
    "data": [
        {
            "estado": "1",
            "icono": "https://sitio.com/my_icon.svg",
            "id": "11",
            "nombre": "My plataform",
            "url": "https://sitio.com/my_platform"
        },
        {
            "estado": "1",
            "icono": "https://sitio.com/icon_test.svg",
            "id": "12",
            "nombre": "My plataform 2",
            "url": "https://sitio.com/my_platform_test"
        }
    ]
}
```

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

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

</th><th style="width: 243px; height: 47px;">Formato</th></tr><tr style="height: 41px;"><td style="width: 174px; height: 41px;">id</td><td style="width: 392px;" width="351">Identificador único de la plataforma.

</td><td style="width: 243px; height: 41px;">Entero</td></tr><tr><td style="width: 174px;">nombre</td><td style="width: 392px;">Nombre que va tener la plataforma

</td><td style="width: 243px;">Texto</td></tr><tr><td style="width: 174px;">estado</td><td style="width: 392px;">Bandera que indica si la plataforma es activa o no

(1 = activo, 0 = inactiva)

</td><td style="width: 243px;">Entero</td></tr><tr><td style="width: 174px;">url

</td><td style="width: 392px;">Url dónde va redireccionar cuando se de clic en el icono.

</td><td style="width: 243px;">Texto</td></tr><tr><td style="width: 174px;">icono</td><td style="width: 392px;">Descripción visual de la plataforma.

</td><td style="width: 243px;">Texto</td></tr></tbody></table>

</div></details>

# Obtener plataforma - getPlatform

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

Obtiene la plataforma especifica que se haya dado de alta anteriormente. **NOTA: Una vez que se crea o actualiza, para verse reflejados los cambios se tiene que esperar alrededor de 5 minutos, ya que se maneja una cache.**

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

<div><table class="table" style="height: 269px;"><tbody><tr style="height: 57px;"><td style="width: 188px; height: 57px;">apikey</td><td style="width: 320px; height: 57px;">Llave de autorización para uso de los Servicios Web.</td><td style="width: 301px; height: 57px;"><span role="presentation" style="padding-right: 0.1px; color: #3366ff;">25sdsd234234aa93sdsdsd37c70118e72</span></td></tr><tr style="height: 41px;"><td style="width: 188px; height: 41px;">token</td><td style="width: 320px; height: 41px;">Token devuelto por el método getToken.</td><td style="width: 301px; height: 41px;"><span style="color: #3366ff;">wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==</span></td></tr><tr><td style="width: 188px;">id</td><td style="width: 320px;">Identificador de la plataforma.</td><td style="width: 301px;"><span style="color: #3366ff;">11</span></td></tr></tbody></table>

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

```shell
curl --location --request POST 'https://api.service24gps.com/api/v1/getPlatform' \
--header 'Cookie: PHPSESSID=0ab8djc97ouk13tev2t9epf1l2' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'\
--form 'id="11"'\
```

##### Respuesta de ejemplo:

```JSON
{
    "status": 200,
    "data": [
        {
            "estado": "1",
            "icono": "https://sitio.com/my_icon.svg",
            "id": "11",
            "nombre": "My plataform",
            "url": "https://sitio.com/my_platform"
        }
    ]
}
```

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

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

</th><th style="width: 223px; height: 47px;">Formato</th></tr><tr style="height: 41px;"><td style="width: 174px; height: 41px;">id</td><td style="width: 412px;">Identificador único de la plataforma.

</td><td style="width: 223px; height: 41px;">Entero</td></tr><tr><td style="width: 174px;">nombre</td><td style="width: 412px;">Nombre que va tener la plataforma

</td><td style="width: 223px;">Texto</td></tr><tr><td style="width: 174px;">estado</td><td style="width: 412px;">Bandera que indica si la plataforma es activa o no

(1 = activo, 0 = inactiva)

</td><td style="width: 223px;">Entero</td></tr><tr><td style="width: 174px;">url

</td><td style="width: 412px;">Url dónde va redireccionar cuando se de clic en el icono.

</td><td style="width: 223px;">Texto</td></tr><tr><td style="width: 174px;">icono</td><td style="width: 412px;">Descripción visual de la plataforma.

</td><td style="width: 223px;">Texto</td></tr></tbody></table>

</div></details>