Excel a JSON

Convierte un archivo Excel o CSV a JSON según un schema

Recibe un archivo .xlsx o .csv y un schema_id, y devuelve los datos transformados en JSON con las claves exactamente iguales a las propiedades definidas en el schema. Si el archivo tiene varias hojas, solo se procesa la primera. La respuesta incluye log_id. Si el schema tiene la verificación de fuente activada, cada propiedad extraída es { value, source } en lugar de un valor plano.

post/excel-json

Request

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

Response

Archivo procesado y transformado correctamente

successboolean
schema_utilizadostring

Nombre del schema aplicado.

total_filas_procesadasinteger

Número de filas de datos transformadas.

mapa_columnasobject

Diccionario que muestra qué columna original se emparejó con qué propiedad del schema.

dataobject[]

Registros transformados según el schema. Si la verificación de fuente está activada en el schema, cada propiedad es un objeto { value, source } (source cita columna y fila; si no hay evidencia, requires_human_revision). Si la verificación de fuente está desactivada, los valores siguen siendo planos.

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": "Leads de Ventas",
  "total_filas_procesadas": 247,
  "mapa_columnas": {
    "Nom_cliente": "nombre_completo",
    "Tlf": "telefono_movil",
    "mail de contacto": "email_contacto"
  },
  "data": [
    {
      "nombre_completo": "Ana María Gómez",
      "cargo": "CEO & Founder",
      "empresa": "TechSolutions",
      "email_contacto": "ana.gomez@techsolutions.com",
      "telefono_movil": "+1 (555) 019-2231"
    }
  ],
  "log_id": "7c2e1a90-4b3d-4f8a-9e21-6d5c8b0a1f34"
}

Changes

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