API REST per integrar sistemes externs, com ara torns de control d'accés físic. Permet consultar l'aptitud dels treballadors i registrar entrades i sortides.
https://www.valida.pro/api/v1
Totes les crides requereixen una clau d'API, creada a Configuració → API. Envia-la a la capçalera:
Authorization: Bearer vld_xxxxxxxxxxxxxxxxxxxxxxxx # x-api-key x-api-key: vld_xxxxxxxxxxxxxxxxxxxxxxxx
Les claus es limiten a la seva organització i als permisos access:read i access:write.
/api/v1/healthComprova la clau i l'estat del servei.
curl -H "Authorization: Bearer $KEY" https://www.valida.pro/api/v1/health
/api/v1/access/check?national_id=12345678AConsulta l'aptitud d'un treballador per DNI/NIE. Retorna el semàfor, els documents bloquejants i les obres autoritzades.
curl -H "Authorization: Bearer $KEY" \
"https://www.valida.pro/api/v1/access/check?national_id=12345678A"
{
"found": true,
"worker": { "id": "…", "name": "Ana García López", "national_id": "12345678A",
"company": "Servicios Bahía Demo SL", "is_active": true },
"status": "apto",
"eligible": true,
"blocking": [],
"projects": ["Reforma del centro demostrador"],
"access_note": null
}/api/v1/access/eventsEl torn registra una entrada o sortida. Si no s'informa decision, la plataforma l'avalua segons l'aptitud.
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
https://www.valida.pro/api/v1/access/events \
-d '{ "national_id": "12345678A", "direction": "in", "gate": "Recepcion-1" }'
{
"event_id": "…", "created_at": "2026-07-05T09:12:00Z",
"direction": "in", "decision": "granted", "reason": null,
"worker": { "id": "…", "name": "Ana García López", … }, "status": "apto"
}/api/v1/access/events?limit=50Llista els últims esdeveniments d'accés registrats.
/api/v1/workers?updated_since=2026-07-01T00:00:00ZSincronitza treballadors i el seu estat d'aptitud amb sistemes externs.
200/201 — correcte400 — paràmetres incorrectes401 — clau d'API absent o no vàlida403 — falta el permís necessari404 — treballador no trobat