Referencia de la API

Base: https://app.nodda.cl/api. Cada request lleva tu token Bearer — ver Autenticación.

Especificación machine-readable (OpenAPI 3.1): https://app.nodda.cl/api/openapi.json

Endpoints

Conexiones — ver Conexiones

Sync — ver Sync

Schedule — ver Schedule

SII — ver SII

Banco Security — ver Banco Security

Mercado Público — ver Mercado Público

BCI PyME — ver BCI PyME

Fuentes — ver Fuentes externas

API keys — ver Autenticación

Convenciones

Autenticación

Authorization: Bearer nodda_sk_.... La organización se deriva de la key. Ver Autenticación.

Content-Type

application/json en requests con cuerpo.

IDs

Todos los identificadores son UUID.

Envelopes de respuesta

Hay tres formas de envelope según el tipo de respuesta:

Objeto único — la mayoría de los GET /{id} y PUT:

{ "data": { ... } }

Lista — los GET de colecciones sin paginación:

{ "data": [ ... ] }

Lista paginada — colecciones que soportan paginación (limit/offset):

{
  "data": [ ... ],
  "pagination": {
    "total": 120,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}

has_more es true cuando offset + data.length < total. Parámetros de paginación:

Dos excepciones devuelven el recurso directamente (sin data):

• POST /connections → 201 con el objeto al tope
• POST /connections/{id}/sync → 202 con el objeto al tope

Envelope de error

{ "error": { "code": "...", "message": "..." } }

El code es estable y pensado para programar contra él. Catálogo completo en Errores.

Secretos

Credenciales, payloads crudos y tokens nunca se exponen en respuestas. Los mensajes de error/progreso van redactados.