Documento a JSON

Extrae datos estructurados de un documento de texto según un schema

Recibe un archivo de documento (.docx, .txt, .md o .rtf) y un schema_id, y devuelve un único objeto JSON con los datos extraídos del documento completo, con las claves exactamente iguales a las propiedades definidas en el schema. El texto se extrae de forma determinista en el servidor ANTES de llamar a la IA (desempaquetado del .docx, decodificación UTF-8 para .txt/.md, stripping de códigos de control para .rtf); solo el texto plano resultante se envía al modelo. El formato legacy .doc (Word 97-2003) no está soportado. Igual que en pdf-json, el documento se trata como una única fuente de datos: la respuesta siempre contiene exactamente un registro en "data". El tamaño máximo de archivo admitido es 10 MB, y el texto extraído no puede superar los 300.000 caracteres. La respuesta incluye log_id. Si la verificación de fuente está activada en el schema, cada propiedad extraída es { value, source }.

post/doc-json

Request

  • Base URL: https://claix.dev/api
  • URL: https://claix.dev/api/doc-json
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Response

Documento analizado y datos extraídos correctamente

successboolean
schema_utilizadostring

Nombre del schema aplicado.

total_registrosinteger

Siempre 1 en este endpoint: el documento completo se trata como una única fuente de datos, no como una tabla de múltiples filas.

dataobject[]

Contiene exactamente un objeto con los datos extraídos del documento, según las propiedades definidas en el schema. Los datos no encontrados en el texto se devuelven como null. Si la verificación de fuente está activada en el schema, cada propiedad es { value, source } (source cita página, párrafo y línea).

log_idstring uuid nullable

Identificador del registro en usage_logs de esta llamada. Presente en respuestas de éxito de extracción, modo agente, document-context y space-context, y en la mayoría de errores una vez autenticada la petición. Puede omitirse si el insert del log falla.

Example response

{
  "success": true,
  "schema_utilizado": "Contratos de Alquiler",
  "total_registros": 1,
  "data": [
    {
      "nombre_arrendatario": "Laura Fernández Ruiz",
      "nombre_arrendador": "Inversiones Delta S.L.",
      "direccion_inmueble": "Calle Mayor 14, 3ºB, Madrid",
      "renta_mensual": 950,
      "fecha_inicio": "2026-04-01"
    }
  ],
  "log_id": "7c2e1a90-4b3d-4f8a-9e21-6d5c8b0a1f34"
}

Changes

No recorded changes to this operation across all 1 revision of this API.