# Referencia de la API

> Todas las operaciones, parámetros, respuestas y esquemas de la API v1, generados desde el contrato OpenAPI 3.1.

Página: https://safeonuba.com/desarrolladores/referencia · API de SafeOnuba v1 (`api_version: "2026-09-24"`), en vista previa: el contrato puede cambiar.

## Entornos

| Entorno | Dirección |
| --- | --- |
| Producción | `https://api.safeonuba.com` |
| Pruebas, con relojes simulados | `https://sandbox.api.safeonuba.com` |

Contrato OpenAPI 3.1: https://safeonuba.com/desarrolladores/openapi.json

## [Autenticación](https://safeonuba.com/desarrolladores/referencia/autenticacion.md)

OAuth2 `client_credentials`: un token opaco de una hora.

- `POST /v1/oauth/token`: Pedir un token (client_credentials)

## [Centros](https://safeonuba.com/desarrolladores/referencia/centros.md)

Los centros del cliente y sus zonas.

- `GET /v1/sites`: Centros del cliente
- `GET /v1/sites/{id}/zones`: Zonas y puntos de reunión de un centro

## [Alertas](https://safeonuba.com/desarrolladores/referencia/alertas.md)

Lo que ha pasado, y reconocerlo o cerrarlo desde la sala del cliente.

- `GET /v1/alerts`: Listar alertas
- `GET /v1/alerts/{id}`: Detalle de una alerta
- `PUT /v1/alerts/{id}`: Reconocer o cerrar una alerta

## [Evacuaciones](https://safeonuba.com/desarrolladores/referencia/evacuaciones.md)

Estado, recuento por estado y por punto, descartes y quién falta.

- `GET /v1/musters`: Listar evacuaciones
- `GET /v1/musters/{id}`: Estado y recuento de una evacuación
- `GET /v1/musters/{id}/missing`: Quién falta

## [Trabajadores](https://safeonuba.com/desarrolladores/referencia/trabajadores.md)

Trabajadores y relojes.

- `GET /v1/workers`: Listar trabajadores
- `GET /v1/workers/{id}`: Detalle de un trabajador
- `GET /v1/devices`: Listar relojes

## [Posiciones](https://safeonuba.com/desarrolladores/referencia/posiciones.md)

Solo las que el velo deja ver.

- `GET /v1/positions/latest`: Últimas posiciones visibles

## [Eventos](https://safeonuba.com/desarrolladores/referencia/eventos.md)

Reproducir los eventos de los últimos 30 días.

- `GET /v1/events`: Reproducir eventos

## [Webhooks](https://safeonuba.com/desarrolladores/referencia/webhooks.md)

Destinos y el formato de lo que se les envía.

- `GET /v1/webhooks`: Listar destinos
- `POST /v1/webhooks`: Crear un destino
- `DELETE /v1/webhooks/{id}`: Borrar un destino
- `POST /v1/webhooks/{id}/rotate-secret`: Rotar el secreto de firma
- `POST /v1/webhooks/{id}/test`: Enviar un evento de prueba

## [Sandbox](https://safeonuba.com/desarrolladores/referencia/sandbox.md)

Escenarios de prueba con relojes simulados, para integrar sin relojes. Solo en `sandbox.api.safeonuba.com`.

- `POST /v1/sandbox/scenarios`: Lanzar un escenario de prueba

## [Esquemas](https://safeonuba.com/desarrolladores/referencia/esquemas.md)