Saltar al contenido
Notificado

Referencia de la API

232 operaciones, generadas desde el documento OpenAPI de Notificado. Cada una tiene su enlace, sus parámetros y ejemplos listos para copiar.

Autenticación

La API pública vive bajo /v1. Cada llamada lleva un token de agente emitido en Cuenta → API: Authorization: Bearer <token>. Sin cookie ni encabezado origin: el token es toda la credencial.

Un token alcanza solo las operaciones que nombran sus alcances; cualquier otra responde 404, igual que si no existiera. Sin token, o con uno vencido o revocado, la respuesta es 401 con WWW-Authenticate.

Cada token puede hacer 120 solicitudes por minuto. Toda respuesta trae RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset; pasado el límite la respuesta es 429 con Retry-After, los segundos que debe esperar.

Las creaciones que llevan la insignia Idempotency-Key en esta referencia (entre ellas createCase, confirmUpload, createNotification, attachDocument y sendNotification) aceptan ese encabezado: un reintento con la misma clave devuelve el primer resultado en lugar de crear dos veces.

Todo listado se pagina igual: _first=<filas> responde { rows, nextCursor, hasMore } y la página siguiente se pide con _after=<nextCursor>. En la última página nextCursor es null. Un _first mayor que el máximo del listado se rechaza con 400 X_INPUT_INVALID; nunca se recorta.

Las operaciones sin ruta /v1 son del panel: responden a una sesión iniciada y pueden cambiar sin aviso. Construya sus integraciones sobre /v1.

Las descripciones de cada operación están en inglés: son las que declara el propio sistema, las mismas que leen los asistentes de IA.

curl
curl 'https://www.notificado.co/v1/case-list?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

API para afiliados

La cuenta de un afiliado tiene su propia API, en https://www.notificado.co/v1/afiliados. Cada llamada lleva un token de afiliado, creado en /afiliados por el propio afiliado aprobado: Authorization: Bearer <token>. Un token de firma no alcanza nada allí, y un token de afiliado no alcanza nada de una firma.

Dos alcances: affiliate:read lee el resumen, el enlace de referido, el estado de la verificación, los estados de cuenta y los movimientos, y descarga el documento soporte (la descarga queda registrada); affiliate:invoices sube y presenta la factura de un estado de cuenta, que espera la confirmación del afiliado en /afiliados.

Postularse y aceptar los términos, la verificación, la cuenta de pago, confirmar una factura y crear o revocar tokens se hacen solo en persona. Ninguna operación pide un identificador de afiliado: el token dice quién es.

curl
curl 'https://www.notificado.co/v1/afiliados/my-affiliate-summary' \
  -H "authorization: Bearer $NOTIFICADO_AFFILIATE_TOKEN"

Inicio de sesión y cuenta

Inicio de sesión y cuenta: las 13 operaciones, con ejemplos

Firma y miembros

Firma y miembros: las 38 operaciones, con ejemplos

Verificación del abogado

Verificación del abogado: las 9 operaciones, con ejemplos

Procesos y documentos

Procesos y documentos: las 39 operaciones, con ejemplos

Notificaciones

Notificaciones: las 47 operaciones, con ejemplos

Evidencia

Evidencia: las 2 operaciones, con ejemplos

Plazos

Plazos: las 8 operaciones, con ejemplos

Créditos, pagos y facturación

Créditos, pagos y facturación: las 28 operaciones, con ejemplos

Afiliados

Afiliados: las 18 operaciones, con ejemplos

Tokens de agente

Tokens de agente: las 14 operaciones, con ejemplos

Públicas y webhooks

Públicas y webhooks: las 16 operaciones, con ejemplos