Validar JSON Schema
Un validador que solo dice 'inválido' apenas es más útil que no tener validador: igual hay que revisar todo el documento a mano para encontrar qué está mal. Este endpoint valida su JSON contra un esquema y señala directamente el campo problemático, su ruta exacta y el motivo del fallo.
Ejecutar — gratis
Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.
La distancia entre 'válido: false' y saber por qué
Muchas librerías de validación pueden decirle que un documento no cumple su esquema, pero se quedan ahí, dejando a un desarrollador o a soporte técnico revisando a ojo un payload con cuarenta campos anidados buscando cuál está mal. data.json_validate está construido bajo la idea de que la respuesta a '¿es válido esto?' nunca es la parte útil; lo útil es exactamente dónde y por qué no lo es, devuelto como una ruta JSON Pointer directa al campo que falla junto con la regla específica que incumplió.
Enviar un documento y su esquema
Envíe por POST tanto su documento JSON como el esquema contra el cual validarlo a /data/json-validate, y recibirá un task_id de inmediato mientras la validación corre en segundo plano. El resultado —un veredicto de aprobado o rechazado más una lista estructurada de cada incumplimiento, con su ruta exacta y la regla del esquema que rompió— llega mediante una llamada de webhook firmada o queda disponible en un enlace firmado válido por 24 horas.
Qué revisa realmente JSON Schema
JSON Schema, estandarizado a través de borradores publicados desde 2010 y actualmente en su versión 2020-12, permite describir no solo la forma de un documento sino sus restricciones: campos obligatorios, patrones de texto, rangos numéricos, valores permitidos, reglas para objetos anidados, todo como un documento escrito en el mismo formato JSON que valida. Eso es lo que distingue una validación de esquema real de una simple revisión de tipo: puede detectar un campo obligatorio que falta en silencio, un texto que no coincide con un patrón esperado o un número fuera de un rango permitido, ninguno de los cuales un analizador básico de 'esto es JSON válido' notaría jamás.
Dónde la validación demuestra su valor en la automatización
El lugar obvio es en el borde de una API, rechazando payloads mal formados de los clientes antes de que lleguen a la lógica de negocio, pero el uso menos evidente y probablemente más valioso está dentro de un pipeline que procesa JSON de muchas fuentes —feeds de socios, salidas de un modelo de lenguaje, cargas de usuarios— donde aceptar en silencio un documento ligeramente incorrecto provoca un fallo tres pasos más adelante que resulta mucho más difícil de rastrear hasta su origen. Como la tarea es asíncrona, se cobra por solicitud y nunca se factura un fallo que en realidad sea un error del propio validador, un pipeline puede validar cada documento que pasa por él como práctica habitual en lugar de tratar la validación como una revisión manual ocasional.
Qué puede hacer con ella
Validación de solicitudes de API antes de procesarlas
Un backend valida los payloads JSON entrantes contra el esquema de su API antes de que lleguen a la lógica de negocio, rechazando solicitudes mal formadas con una ruta de error específica.
Verificación de salidas de un modelo de lenguaje
Un pipeline de automatización valida el JSON estructurado devuelto por un modelo de lenguaje contra un esquema esperado antes de actuar sobre cualquiera de sus campos.
Control de calidad de feeds de socios
Una plataforma de datos valida cada feed JSON entrante de un socio contra un esquema compartido y marca cualquier registro que lo incumpla antes de que entre al almacén de datos.
Corrección de archivos de configuración en integración continua
Un pipeline de integración continua valida archivos de configuración en JSON contra un esquema en cada commit, detectando errores de escritura y campos obligatorios faltantes antes del despliegue.
Preguntas frecuentes
¿Cómo valido JSON contra un esquema con la API?
Envíe su documento JSON y su JSON Schema por POST a /data/json-validate, guarde el task_id devuelto y reciba el resultado de la validación por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API para validar JSON Schema?
No, no hay plan gratuito ni prueba; cuesta $0.002 por solicitud, y una solicitud fallida por un error propio del servicio nunca se cobra.
¿Qué contiene realmente la salida de error?
Para cada incumplimiento recibe la ruta JSON Pointer exacta hacia el campo que falla, la regla del esquema que incumplió y un mensaje legible explicando por qué.
¿Qué borrador de JSON Schema soporta?
Soporta borradores modernos de JSON Schema, incluido 2020-12, cubriendo palabras clave estándar como required, type, pattern, enum y reglas para objetos y arreglos anidados.
¿Reporta todos los errores o solo el primero?
Reporta todos los incumplimientos encontrados en una sola pasada, no solo el primero, para que pueda corregir un documento en una sola ronda en lugar de un error a la vez.
¿Puedo usarlo para validar JSON generado por un modelo de lenguaje?
Sí, validar la salida estructurada de un modelo de lenguaje contra un esquema esperado antes de actuar sobre ella es uno de los usos más comunes de este endpoint.
¿Puedo validar muchos documentos por lote?
Sí, envíe una tarea asíncrona por documento y reciba cada resultado por webhook a medida que termine, lo cual funciona bien para pipelines que validan grandes volúmenes.
¿Se guardan mis datos JSON después de la validación?
No, los documentos y esquemas enviados se eliminan después del período de retención y nunca se usan para entrenamiento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/data/json-validate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/data/json-validate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/data/json-validate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/json-validate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/json-validate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "data.json_validate",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 25 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |