API

Conecta tus sistemas con claves de API acotadas.

Un admin crea claves de servidor a servidor con scopes upload, query o ask, caducidad opcional y revocación inmediata. Con dos llamadas tu ERP crea un documento y sube el archivo; con una tercera busca o pregunta.

3 SCOPESUPuploadQqueryASKaskSHASe muestra una sola vez
TUS SISTEMAS, CONECTADOS

Cada sistema con su clave, y cada clave con su alcance.

Las claves tienen el formato ari_…, se guardan solo como hash SHA-256 y se muestran una única vez al crearlas.

ERPERP● upload
Sube facturas y pedidos
POST /api/v1/documents
CRMCRM● query
Busca contratos
POST /api/v1/query
PORPortal● ask
Preguntas con fuentes
POST /api/v1/ask
KEYClave ari_…● SHA-256
Se muestra una vez
Caducidad opcional
REVRevocar● Inmediato
Desde Settings
Confirm revoke
LIMLímites● Por persona y workspace
Con Retry-After
429
La clave no ve todo: solo documentos sin colección o de colecciones de todo el workspace.
Los scopes dependen del plan: ask está en Professional y Enterprise.
CÓMO SE INTEGRA

De la clave a tu primer documento en tres llamadas.

1 · CLAVESettings → API Keys

Nombre, scopes y caducidad opcional. Cópiala: no se vuelve a mostrar.

2 · CREAREl documento

POST /api/v1/documents con tipo y título.

3 · SUBIREl archivo

POST /api/v1/documents/{id}/upload, hasta 25 MB.

4 · BUSCAR O PREGUNTARCon fuentes

POST /api/v1/query o /api/v1/ask.

Para que Search y Ask lo encuentren: lo subido por API se indexa al publicarlo o con «Index for Ask».
PRUÉBALO — CONSOLA DE EJEMPLO

Llama a la API y mira cada respuesta.

«Distribuidora Norte» · clave «ERP ingestion» · scopes upload, query.

Sobre upload
POST /api/v1/documents · {"type_id": "Factura", "title": "Factura F-2026-0042"}
201 CREATED

id: 6b1f… · versión 1

X-API-Key: ari_…

Datos de ejemplo.

CLAVES SEGURAS

Acotadas, revocables y nunca guardadas en claro.

01Hash SHA-256

La clave en claro solo se ve una vez.

02Scopes

upload, query y ask, según el plan.

03Caducidad

Opcional, con fecha.

04MFA

Crear claves exige MFA a los admins.

Límites de uso

Valores por persona; al superarlos la API responde 429 con Retry-After.

EndpointPor minutoPor díaWorkspace / día
/api/v1/query602.00010.000
/api/v1/ask103002.000
/api/v1/ask/deep350500
Subida10100500
HONESTO POR DISEÑO

Lo que hace la API hoy.

5 endpoints con clave

Crear, subir, buscar, preguntar y análisis profundo.

Sin webhooks salientes

NexDok no envía eventos a tus sistemas.

Indexación aparte

Lo subido se indexa al publicarlo o al pedirlo.

Errores claros

422 sin eco de valores, 429 con Retry-After.

LA PANTALLA DE CLAVES

Crea, copia y revoca desde Settings.

Solo owners y admins crean claves. Los scopes que el plan no incluye aparecen con «Upgrade».

Create API keyCopy API keyRevokeScopesExpires at
API Keys2 activas
ERP INGESTIONuploadquery
CRM SEARCHquery—
PLAN5claves máx.
UploadQueryAsk · Upgrade
API key created: Copy now — shown once only
UNA RESPUESTA REAL

Pregunta desde tu sistema y recibe las fuentes.

/api/v1/ask responde solo con el contexto recuperado y lista las fuentes; sin contexto, lo dice sin llamar a la IA.

POST /api/v1/ask · {"question": "¿Cuál es la política de cancelación?"}
ANSWER

Las cancelaciones se aceptan hasta 48 horas antes…

SOURCES

document_id · version_id · chunk_index · similarity

Scope ask · Professional y Enterprise
Owner o Admin

Crea y revoca claves.

Scopes del plan

upload y query; ask en Professional y Enterprise.

HTTPS + X-API-Key

Cabecera en cada llamada.

Documentos indexados

Para query y ask.

¿Qué sistema quieres conectar primero?

Cuéntanos tu ERP, CRM o portal. Te ayudamos con la integración.

Contáctanos