Centro de documentación
Guía 01

Inicio rápido

Crea una credencial en la plataforma, indica tu organización y haz la primera llamada a LPDATOS API v1.

Índice de guías

Antes de comenzar

Necesitas tres datos. Los tres se obtienen desde la plataforma, no por API.

export BASE_URL='https://app.lpdatos.cl'
export ORGANIZATION='<hub-tenant-id-o-uuid>'
export TOKEN='lpd_<id>_<secreto>'
  • BASE_URL es el host de la plataforma LPDATOS.CL. La API vive en el mismo dominio que la aplicación, bajo /api/v1.
  • ORGANIZATION acepta el identificador Hub (tenant) o el UUID de la organización. Ambos aparecen en Configuración → Organización.
  • TOKEN es una credencial creada en Configuración → Tokens API por una persona con permiso de administración de la organización. Tiene prefijo lpd_, se muestra una sola vez al crearla y lleva los permisos que se marcaron en ese momento.

Primera llamada

Este ejemplo registra una solicitud de rectificación. Requiere el permiso requests:create. La solicitud queda pending con su vencimiento calculado: la llamada abre el expediente; la rectificación se resuelve desde la plataforma.

curl --fail-with-body \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  "$BASE_URL/api/v1/organizations/$ORGANIZATION/requests" \
  --data '{
    "requestType": "rectification",
    "subjectType": "email",
    "subjectValue": " Ada@Example.COM ",
    "notes": "Pidió corregir su dirección."
  }'

Respuesta 201

{
  "id": 42,
  "uuid": "d539f65e-e982-46af-a7ea-9ae01d452227",
  "requestType": "rectification",
  "status": "pending",
  "source": "api",
  "subjectType": "email",
  "subjectValueHash": "b5fc85e55755f9e0d030a10ab4429b6b2944855f9a0d60077fe832becbc41d72",
  "affectedCount": 1,
  "notes": "Pidió corregir su dirección.",
  "dueAt": "2026-09-22T04:00:00.000+00:00",
  "slaState": "on_time",
  "escalated": false,
  "extensionRequestedAt": null,
  "extensionReason": null,
  "identityPending": true,
  "identityVerifiedAt": null,
  "identityVerificationMethod": null,
  "resolvedAt": null,
  "createdAt": "2026-08-23T04:00:00.000+00:00",
  "updatedAt": "2026-08-23T04:00:00.000+00:00"
}

Los UUID, IDs y fechas son ilustrativos. El método, la ruta, los campos y el código de estado corresponden al contrato OpenAPI que publica la plataforma en /api/v1/openapi.json.

Próximos pasos

  1. Revisa credenciales y permisos.
  2. Entiende cómo se resuelve :organization.
  3. Implementa el manejo del arreglo errors.
  4. Consulta la referencia OpenAPI para revisar todas las operaciones.

Límites actuales

API v1 registra y consulta solicitudes ARCOP, registra y retira consentimientos, y lista supresiones y proveedores. Resolver una solicitud, exportar datos, rectificar o suprimir se hace desde el expediente en la plataforma. No hay endpoints para emitir o rotar credenciales, webhooks salientes ni operaciones masivas.

¿Necesitas el contrato exhaustivo?Revisa parámetros, esquemas y respuestas de todas las operaciones en la referencia.Abrir referencia
WhatsApp