For the complete documentation index, see llms.txt. This page is also available as Markdown.

Setear zonas a dispositivo

Este endpoint permite asignar zonas a un dispositivo. El dispositivo "pierde" las zonas que tenía asignada anteriormente. Si sólo quiere Asignar zonas o Desasignar zonas, revise los endpoints correspondientes.

POST https://api.persat.com.ar/v1/devices/:device_id/zones

Headers

Name
Type
Description

Content-Type

string

application/json

Authorization

string

Bearer API_KEY

Path parameters

Name
Type
Description

:device_id*

number

Identificador del dispositivo al cual le quiero asignar las zonas

Request Body

Name
Type
Description

zone_ids*

number[]

Array con enteros. Cada uno de los enteros es el id de la zona que quiero asignar.

{
    "success": true,
    "data": {}
}
{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "La zone o el device_id no existe/n"
    }
}
{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe un device con este id: 1433"
    }
}

Ejemplo de Request

Ejemplo de body, en donde seteamos las 3 zonas que definimos para este dispositivo.

{
    "zone_ids": [2,3,4]
}

Analizando la Respuesta

data: Es un objeto JSON vacío

Si alguna de las zonas no se puede asignar. Entonces no se asigna ninguna zona y se recibe un error. Es decir que basta con revisar status 200 para verificar que las zonas fueron asignadas.

Last updated