Referencia

Trabajadores

Trabajadores y relojes.

Listar trabajadores

GET/v1/workers

Scope workers:read

Parámetros de consulta

site_idstring (uuid)
limitinteger
Elementos por página (máximo 500).
de 1 a 500 · por defecto 100
cursorstring
El next_cursor de la página anterior.

Respuestas

200
Trabajadores.
application/json WorkerPage
401
Falta el token, ha caducado o se ha revocado.
application/problem+json Problem
403
Al token le falta el scope que pide la ruta, o el centro no es del cliente.
application/problem+json Problem
429
Demasiadas peticiones, o demasiado tiempo de consulta: cada cliente tiene un número de peticiones por minuto (600 de serie) y un tiempo de consulta por minuto (30 s de serie), y cada petición gasta lo que tarda, así que una lista larga cuenta más que una alerta suelta. Retry-After dice cuándo volver.
application/problem+json Problem

Petición · sandbox

curl "https://sandbox.api.safeonuba.com/v1/workers" \
  -H "Authorization: Bearer $SAFEONUBA_TOKEN"

const res = await fetch('https://sandbox.api.safeonuba.com/v1/workers', {
  headers: {
    Authorization: `Bearer ${process.env.SAFEONUBA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

res = requests.get(
    "https://sandbox.api.safeonuba.com/v1/workers",
    headers={"Authorization": f"Bearer {os.environ['SAFEONUBA_TOKEN']}"},
    timeout=10,
)
res.raise_for_status()
data = res.json()

using System.Net.Http.Headers;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("SAFEONUBA_TOKEN"));

var res = await http.GetAsync("https://sandbox.api.safeonuba.com/v1/workers");
res.EnsureSuccessStatusCode();
var json = await res.Content.ReadAsStringAsync();

Respuesta 200

JSON

{
  "data": [
    {
      "id": "0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90",
      "external_id": "EMP-004512",
      "name": "Ana Ejemplo",
      "contractor": "Contrata Ejemplo A",
      "role": "Andamiero",
      "is_active": false,
      "device": {
        "id": "0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90",
        "serial": "OS-W-0005",
        "battery": 64,
        "date_last_seen": "2026-09-24T11:04:12Z"
      },
      "date_last_seen": "2026-09-24T11:04:12Z"
    }
  ],
  "next_cursor": "eyJ0IjoiMjAyNi0wOS0yNFQxMTowNDoxMloifQ"
}

Detalle de un trabajador

GET/v1/workers/{id}

Scope workers:read

Parámetros de ruta

idstring (uuid)obligatorio
Id del trabajador.

Respuestas

200
El trabajador.
application/json Worker
401
Falta el token, ha caducado o se ha revocado.
application/problem+json Problem
403
Al token le falta el scope que pide la ruta, o el centro no es del cliente.
application/problem+json Problem
404
No existe o no lo ve esta identidad.
application/problem+json Problem
429
Demasiadas peticiones, o demasiado tiempo de consulta: cada cliente tiene un número de peticiones por minuto (600 de serie) y un tiempo de consulta por minuto (30 s de serie), y cada petición gasta lo que tarda, así que una lista larga cuenta más que una alerta suelta. Retry-After dice cuándo volver.
application/problem+json Problem

Petición · sandbox

curl "https://sandbox.api.safeonuba.com/v1/workers/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90" \
  -H "Authorization: Bearer $SAFEONUBA_TOKEN"

const res = await fetch('https://sandbox.api.safeonuba.com/v1/workers/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90', {
  headers: {
    Authorization: `Bearer ${process.env.SAFEONUBA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

res = requests.get(
    "https://sandbox.api.safeonuba.com/v1/workers/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90",
    headers={"Authorization": f"Bearer {os.environ['SAFEONUBA_TOKEN']}"},
    timeout=10,
)
res.raise_for_status()
data = res.json()

using System.Net.Http.Headers;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("SAFEONUBA_TOKEN"));

var res = await http.GetAsync("https://sandbox.api.safeonuba.com/v1/workers/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90");
res.EnsureSuccessStatusCode();
var json = await res.Content.ReadAsStringAsync();

Respuesta 200

JSON

{
  "id": "0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90",
  "external_id": "EMP-004512",
  "name": "Ana Ejemplo",
  "contractor": "Contrata Ejemplo A",
  "role": "Andamiero",
  "is_active": false,
  "device": {
    "id": "0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90",
    "serial": "OS-W-0005",
    "battery": 64,
    "date_last_seen": "2026-09-24T11:04:12Z"
  },
  "date_last_seen": "2026-09-24T11:04:12Z"
}

Listar relojes

GET/v1/devices

Scope workers:read

Parámetros de consulta

site_idstring (uuid)
limitinteger
Elementos por página (máximo 500).
de 1 a 500 · por defecto 100
cursorstring
El next_cursor de la página anterior.

Respuestas

200
Relojes: batería, si está puesto, última conexión.
application/json DevicePage
401
Falta el token, ha caducado o se ha revocado.
application/problem+json Problem
403
Al token le falta el scope que pide la ruta, o el centro no es del cliente.
application/problem+json Problem
429
Demasiadas peticiones, o demasiado tiempo de consulta: cada cliente tiene un número de peticiones por minuto (600 de serie) y un tiempo de consulta por minuto (30 s de serie), y cada petición gasta lo que tarda, así que una lista larga cuenta más que una alerta suelta. Retry-After dice cuándo volver.
application/problem+json Problem

Petición · sandbox

curl "https://sandbox.api.safeonuba.com/v1/devices" \
  -H "Authorization: Bearer $SAFEONUBA_TOKEN"

const res = await fetch('https://sandbox.api.safeonuba.com/v1/devices', {
  headers: {
    Authorization: `Bearer ${process.env.SAFEONUBA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

res = requests.get(
    "https://sandbox.api.safeonuba.com/v1/devices",
    headers={"Authorization": f"Bearer {os.environ['SAFEONUBA_TOKEN']}"},
    timeout=10,
)
res.raise_for_status()
data = res.json()

using System.Net.Http.Headers;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("SAFEONUBA_TOKEN"));

var res = await http.GetAsync("https://sandbox.api.safeonuba.com/v1/devices");
res.EnsureSuccessStatusCode();
var json = await res.Content.ReadAsStringAsync();

Respuesta 200

JSON

{
  "data": [
    {
      "id": "0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90",
      "serial": "OS-W-0005",
      "battery": 64,
      "date_last_seen": "2026-09-24T11:04:12Z",
      "model": "Galaxy Watch6",
      "status": "active",
      "worn": true,
      "worker": {
        "id": "0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90",
        "external_id": "EMP-004512",
        "name": "Ana Ejemplo",
        "contractor": "Contrata Ejemplo A"
      }
    }
  ],
  "next_cursor": "eyJ0IjoiMjAyNi0wOS0yNFQxMTowNDoxMloifQ"
}

Trabajadores

Listar trabajadores#

Parámetros de consulta

Respuestas

Detalle de un trabajador#

Parámetros de ruta

Respuestas

Listar relojes#

Parámetros de consulta

Respuestas

Listar trabajadores

Detalle de un trabajador

Listar relojes