Documentación APIPiloto RAT inicial

Piloto RAT sostenido

Requiere una conexión de prueba expresamente habilitada por GTD. La conexión anterior conserva su alcance. No usar datos personales reales. Se admiten tres fuentes ficticias, identificadas por cox-rat-sustained-001, 002 y 003.

Preparar el origen

Descarga en una carpeta gtd-api-comprobar.mjs, gtd-api-rat.mjs y gtd-api-rat-sostenido.mjs. Usa Node.js 20 o posterior y la clave privada local de la conexión sostenida. GTD recibe sólo la clave pública durante la preparación; no incluyas la privada en eventos, URLs ni capturas.

Genera los tres eventos una sola vez:

node gtd-api-rat-sostenido.mjs fixtures --connection-id CONEXION --output-directory eventos-rat

El comando crea una carpeta nueva con evento-1.json, evento-2.json y evento-3.json en UTF-8; envios.json indica sus claves de idempotencia. No sobrescribe carpetas existentes. Conserva sus eventId, occurredAt, cuerpo y una clave de idempotencia única por envío. Generar fixtures no transmite datos.

Enviar y resolver

node gtd-api-rat.mjs --client-id CLIENT_ID --key-file privada.json --event-file eventos-rat/evento-1.json --idempotency-key CLAVE_DE_ENVIOS_JSON
node gtd-api-rat.mjs --client-id CLIENT_ID --key-file privada.json --event-id PUBLIC_EVENT_ID

HTTP 202 indica recepción. Cada fuente nueva queda pendiente: una persona con permiso de escritura RAT abre Conexiones API → sistema → Revisiones RAT, compara datos y confirma aprobación o rechazo. La consulta del evento informa el resultado. Repite el recorrido para las otras dos fuentes.

Tras aprobar una fuente, envía una observación nueva con fecha posterior y otro eventId/clave. El nombre PRUEBA RAT sostenido N actualizado puede aplicarse automáticamente si todo lo demás coincide con la referencia aprobada y nadie cambió el RAT. La finalidad Validar finalidad ficticia revisada N requiere revisión. N debe coincidir con la fuente (1, 2 o 3). Sólo se admiten los valores ficticios acordados; el prefijo PRUEBA por sí solo no basta.

Consultar actividades propias

node gtd-api-rat-sostenido.mjs activities --client-id CLIENT_ID --key-file privada.json --page-size 20

Requiere rat:activities:read. Si nextCursor no es null, pásalo con --cursor en la siguiente consulta. Sólo devuelve las actividades vinculadas a esa conexión. El estado active/suspended es el declarado por el origen; no archiva el RAT.

Resolver incertidumbre y conflictos

Si editas una actividad ficticia desde RAT y el formulario exige campos adicionales, conserva su identificación como prueba. Una base jurídica o retención ingresadas para el ensayo no constituyen una evaluación de cumplimiento real. La ventana lógica de siete días no acredita borrado físico.

La conexión de prueba no incluye otros módulos, SDKs ni habilitación comercial general. Contacto: contacto@gestionatusdatos.cl.

La consulta externa muestra la última versión aprobada y aplicada desde esa conexión. No exporta posteriores ediciones humanas del RAT; la revisión en GTD sí muestra los valores actuales.