Drometra
Solicitar acceso

Cuenta y acceso

Quién llama, en qué empresa y con qué rol.

Ver el contexto de la sesión

GEThttps://api.drometra.com/v1/context

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Respuesta · 200

  • actorIdstring · uuidsiempre
  • tenantIdstring · uuidsiempre
  • roleenum: viewer | operator | admin | driversiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X GET "https://api.drometra.com/v1/context" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"
respuesta · 200
{
  "actorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "role": "viewer"
}

Listar mis empresas

GEThttps://api.drometra.com/v1/me/tenants

Pide el token de acceso de una persona de tu empresa.

Respuesta · 200

  • array de objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X GET "https://api.drometra.com/v1/me/tenants" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "Accept: application/json"
respuesta · 200
{
  "items": [
    {
      "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "name": "…",
      "role": "viewer"
    }
  ]
}

Listar miembros

GEThttps://api.drometra.com/v1/members

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Respuesta · 200

  • actorIdstring · uuidsiempre
  • roleenum: viewer | operator | admin | driversiempre
  • activebooleansiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X GET "https://api.drometra.com/v1/members" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"
respuesta · 200
[
  {
    "actorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "role": "viewer",
    "active": true
  }
]

Cambiar un miembro

PATCHhttps://api.drometra.com/v1/members/{id}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid
ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

roleobligatorioenum: viewer | operator | admin | driver
activeobligatorioboolean

Respuesta · 200

  • actorIdstring · uuidsiempre
  • roleenum: viewer | operator | admin | driversiempre
  • activebooleansiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X PATCH "https://api.drometra.com/v1/members/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "…",
    "active": true
  }'
respuesta · 200
{
  "actorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "role": "viewer",
  "active": true
}

Consultar la auditoría

GEThttps://api.drometra.com/v1/audit

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de consulta

afterstring · uuid
limitinteger

Respuesta · 200

  • idstring · uuidsiempre
  • tenantIdstring · uuidsiempre
  • actorIdstring · uuidsiempre
  • requestIdstring · uuidsiempre
  • resourceIdstring · uuidsiempre
  • actionstringsiempre
  • outcomestringsiempre
  • createdAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X GET "https://api.drometra.com/v1/audit" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"
respuesta · 200
[
  {
    "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "actorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "requestId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "resourceId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "action": "…",
    "outcome": "…",
    "createdAt": "2026-10-21T14:02:31Z"
  }
]