Obtener Dispositivo

Para obtener un dispositivo particular se debe realizar un GET como el que se muestra a continuación.

GET https://api.persat.com.ar/v1/devices/device_id

Path Parameters

Name	Type	Description
device_id*	Number	Identificador del dispositivo

Headers

Name	Type	Description
Authorization*	String	Bearer API_KEY

200: OK La consulta se ejecutó con éxito

{
    "success": true,
    "data": {
        "id": 104,    
        "type": "VEHICLE",
        "serial_number": "3213213-ABCD....",
        "first_name": "Martin Gonzalez",
        "last_name": "LKL 987",
        "working_zones": [
            {
                "id": 2,
                "created": "2013-08-16T14:27:20.000Z",
                "name": " GBA Norte"
            }, { ... }
        ],
        "working_hours": {
            "monday": [],
            "tuesday": [
                {
                    "start": "05:05",
                    "end": "06:06"
                }
            ],
            "wednesday": [],
            "thursday": [],
            "friday": [],
            "saturday": [],
            "sunday": [
                {
                    "start": "01:01",
                    "end": "02:02"
                }
            ]
        }
    }
}

404: Not Found No se encontro el dispositivo

{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe un device con este id"
    }
}

400: Bad Request device_id no es un número

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'device_id' debe ser un número entero"
    }
}

Analizando la Respuesta

{
    "success": true,
    "data": {
        "id": 104,    
        "type": "VEHICLE",
        "serial_number": "3213213-ABCD....",
        "first_name": "Martin Gonzalez",
        "last_name": "LKL 987",
        "working_zones": [
            {
                "id": 2,
                "created": "2013-08-16T14:27:20.000Z",
                "name": " GBA Norte"
            }, { ... }
        ],
        "working_hours": {
            "monday": [],
            "tuesday": [
                {
                    "start": "05:05",
                    "end": "06:06"
                }
            ],
            "wednesday": [],
            "thursday": [],
            "friday": [],
            "saturday": [],
            "sunday": [
                {
                    "start": "01:01",
                    "end": "02:02"
                }
            ]
        }
    }
}

id: Identificador del Dispositivo.

first_name: Nombre

last_name: Apellido

first_name y last_name se pueden usar libremente y pueden identificar a un vehiculo, por ejemplo con su modelo y patente

type: Tipo de dispositivo. Puede ser "VEHICLE" o "CELLPHONE"

serial_number: Identificador unico del dispositivo físico. Por ejemplo, los dispositivos de tipo VEHICLE, usan como identificador el número de serie del equipo de rastreo, mientras que los de tipo CELLPHONE usan el imei o el número de serie de la placa de video del teléfono.

El serial_number es meramente informativo, bajo ninguna circunstancia debe ser utilizado como identificador

working_zones. Array con las zonas de trabajo asignadas. Los campos se describen en Obtener Zona

working_hours. Objeto json que contiene en cada key el día de la semana. Cada día de la semana es un array con objetos { start: "HH:mm", end: "HH:mm }. Indicando inicio y fin de jornada laboral.

Es un array, ya que se contempla para un futuro permitir horarios partidos. Es decir jornadas laborales con descansos intermedios.

Si el array está vacío, significa que no es un dia laborable.