Errores

Esta es la lista completa de errores de la API de la plataforma Kaleidr. Cada uno tiene un estado HTTP y un código: una cadena corta y estable con la que se puede decidir qué hacer. El estado por sí solo no basta. 403 tiene muchas causas diferentes, y 429 puede significar tanto «reduzca el ritmo» como «se ha agotado la cuota».

Comience por los formatos de respuesta, porque el código no siempre está en el mismo campo.

Formatos de respuesta

Formato	Ejemplo	Se utiliza para
Código envuelto	{"detail": "origin_not_allowed"}	Casi todos los errores 401, 403, 404, 413, 500 y 503, los códigos de límites de solicitud 422 y dos errores 429 (map_load_quota_exceeded e ingest_rate_limited de la API de carga). El código es la cadena detail.
Objeto plano	{"error": "rate_limited", "detail": "API key rate limit exceeded. Slow down."}	Todos los demás errores 429. El código es error; detail contiene una frase destinada al usuario. Los errores de cuota incluyen otros campos.
Lista de validación	{"detail": [{"loc": ["body", "product"], "msg": "…", "type": "…"}]}	Error 422 por un cuerpo o una consulta mal formados. detail es una matriz con una entrada por problema.
Error con 200	{"error": "Route planning failed."}	Solo POST /chat/control/route. Consulte más abajo.

Una función que obtiene el código de cualquiera de esos formatos:

async function kaleidrError(res) {
  const body = await res.json().catch(() => ({}));
  const code =
    typeof body.error === 'string' ? body.error :      // flat 429
    typeof body.detail === 'string' ? body.detail :    // wrapped code
    Array.isArray(body.detail) ? 'validation_error' :  // 422
    'unknown_error';
  return { status: res.status, code, body, retryAfter: Number(res.headers.get('retry-after')) || null };
}

Hay dos cabeceras importantes: Retry-After, que indica en segundos cuánto esperar ante una respuesta 429, y X-Request-Id, cuando está presente, que identifica la solicitud al contactar con soporte.

Autenticación: 401

La API no acepta las credenciales.

Código	Cuándo ocurre	Qué hacer
Invalid or missing API key	No se enviaron credenciales o la clave es desconocida, fue revocada o ha caducado. También ocurre con un token de sesión caducado; una sesión cuya clave fue revocada o rotada sin período de gracia; una sesión cuyo origen o producto se eliminó de su clave; una sesión emitida antes de cambiar a un plan inferior; o una organización suspendida o sin plan.	Compruebe la clave y su estado en kaleidr.com/api-keys. En el caso de una sesión, intercámbiela de nuevo. Si una clave válida sigue fallando, vuelva a intentarlo al cabo de unos instantes: un fallo temporal de la plataforma también produce esta respuesta.
publishable_requires_session	Se envió una clave publicable (kld_pk_…) a un endpoint de ejecución.	En el navegador, deje que el SDK la intercambie o llame primero a POST /sdk/sessions. En el backend, utilice una clave de servidor.

Autorización: 403

La API reconoce las credenciales, pero rechaza esta solicitud.

Código	Cuándo ocurre	Qué hacer
insufficient_scope	La clave se creó sin el permiso que necesita este endpoint o producto.	Use una clave que tenga ese permiso. No se pueden añadir permisos a una clave existente.
tier_capability_not_allowed	La clave incluye el permiso o producto, pero el plan actual de su organización no lo permite. También se devuelve para un mapa publicado si el plan de su propietario no incluye el chat. No se devuelve para vendor: una clave con vendor en un plan inferior a Enterprise no se rechaza, pero sus respuestas se generan sin sus datos.	Cambie de plan o utilice un producto incluido en él.
server_key_in_browser	Se envió una clave de servidor (kld_sk_…) con la cabecera Origin.	Traslade la llamada a su backend. Si la clave apareció en el código fuente de la página, rótela.
session_origin_mismatch	Se utilizó un token de sesión desde un origen distinto de aquel para el que se emitió, o una sesión de mapa publicado sin Origin.	Intercambie la sesión en la página que vaya a utilizarla.
ip_not_allowed	Se llamó con una clave de servidor o heredada que tiene una lista de IP permitidas desde una dirección externa a la lista, o no se pudo determinar la dirección de origen.	Llame desde una dirección permitida o cambie allowed_ips en la clave.
publishable_key_required	Se llamó a POST /sdk/sessions con una clave de servidor o heredada.	Use una clave publicable para el intercambio.
origin_required	El intercambio de sesión no incluía la cabecera Origin.	Realice el intercambio desde una página del navegador.
origin_not_allowed	El origen de la página no figura entre los orígenes permitidos por la clave o entre los dominios permitidos del mapa publicado.	Añada el origen exacto a la clave o el dominio al mapa.
product_not_allowed	La clave está limitada a determinados productos y la solicitud es para otro. Durante el intercambio: el product solicitado no está entre los productos permitidos de la clave publicable. En un endpoint de ejecución: una clave de servidor o heredada llama a un endpoint de un producto no permitido; por ejemplo, una clave limitada a tile que llama a /chat/*.	Modifique allowed_products o use otra clave.
chat_disabled	Intercambio de mapa publicado: la Kaleidr AI del mapa no activa la función solicitada.	Active Control Tower o Popup Window en el mosaico Kaleidr AI del mapa en Studio.
feature_not_granted	Se usó en /chat/control/stream una sesión de mapa publicado abierta para el chat emergente. Cada función tiene su propia sesión.	Intercambie una sesión con "feature": "control_tower", que el mapa concede mientras Control Tower está activado.
owner_has_no_organization	Intercambio de mapa publicado: el propietario del mapa no tiene una organización a la que imputar el consumo.	El propietario debe crear una organización o unirse a una.

No encontrado: 404

Código	Cuándo ocurre	Qué hacer
not_found	Intercambio de mapa publicado: no existe un mapa publicado ni un enlace compartido con ese share_id.	Compruebe el identificador y que el mapa esté publicado.
sessions_disabled	El intercambio de sesiones está desactivado en la plataforma.	No puede resolverlo por su cuenta. Contacte con soporte.
Not Found	La ruta no existe.	Compare la URL con Endpoints, incluida la ruta base /inference-api/b2b/v1.

Validación: 422

El cuerpo o la cadena de consulta no cumplen lo que acepta el endpoint. detail es una matriz; el campo loc de cada entrada identifica el campo y msg indica el problema.

{
  "detail": [
    { "type": "missing", "loc": ["body", "product"], "msg": "Field required", "input": {} }
  ]
}

Corrija la solicitud; no vuelva a enviarla sin cambios. Dos endpoints de streaming, /chat/summary/stream y /chat/button/stream, responden con 500 en lugar de 422 si el cuerpo está mal formado, excepto cuando un campo supera el límite de longitud (véase más abajo).

Límites de solicitudes: 422 con código

Una solicitud bien formada que supera un límite de tamaño también devuelve 422, pero con el formato envuelto: detail contiene el código como cadena, no como matriz. No se cobra nada.

{ "detail": "conversation_too_long" }

Código	Endpoint	Cuándo ocurre	Qué hacer
too_many_messages	/chat/control/stream	messages contiene más de 400 entradas.	Envíe solo los turnos más recientes.
message_too_long	/chat/control/stream	El content de un mensaje supera los 64.000 caracteres.	Acorte el mensaje.
conversation_too_long	/chat/control/stream	La suma de los campos content de todos los mensajes supera los 200.000 caracteres.	Elimine los turnos más antiguos y vuelva a enviar.
invalid_session_id	/chat/control/stream	session_id supera los 128 caracteres o contiene algún carácter distinto de letras, dígitos, _, ., : o -.	Utilice un identificador con ese formato, por ejemplo, un UUID.
lang_too_long	/chat/control/stream	lang supera los 35 caracteres.	Envíe una etiqueta BCP 47 como pt-BR.
invalid_layout	/chat/control/stream	layout supera los 16 caracteres.	Envíe guide mientras el viewer muestra su diseño de guía, u omita el campo.
field_too_long	/chat/summary/stream, /chat/button/stream	Un campo de texto supera su longitud máxima o una lista contiene más entradas de las permitidas.	Acorte el campo. Los límites figuran en Endpoints.

Los límites del flujo de chat se describen en Endpoints.

Solicitud demasiado grande: 413

Código	Cuándo ocurre	Qué hacer
request_too_large	El cuerpo de la solicitud supera los 2 MiB, o los 5 MiB en un endpoint /design/*. El cuerpo de la respuesta es {"detail": "request_too_large"}. No se cobra nada.	Envíe menos datos: reduzca el historial de conversación o las filas de ejemplo de una solicitud de diseño. No reenvíe el mismo cuerpo.
request_body_too_large	Una solicitud a las rutas de administración de claves o datos empresariales en /shared-api supera 1 MiB, o supera 32 MiB en la carga POST /shared-api/datahub/ingests.	Envíe un cuerpo más pequeño. Para cargas, consulte Cargar sus datos empresariales.

Una solicitud cuyo tamaño declarado supera ampliamente los límites de cualquier endpoint puede rechazarse en el borde de la red antes de llegar a la API. Esa respuesta no tiene un cuerpo JSON de Kaleidr y, por tanto, no contiene un código que leer: envíe menos datos.

Una solicitud rechazada por su tamaño, igual que cualquier otra rechazada antes de procesarse, no se cobra y no mantiene reservados créditos de IA ni una plaza de concurrencia.

Límites de cuota y frecuencia: 429

Lea el cuerpo de la respuesta antes de decidir si debe reintentarla.

Código	Campo	Retry-After	Cuándo ocurre	Qué hacer
quota_exceeded	error	segundos hasta reset_at	Los créditos de IA de tu organización no alcanzan para cubrir la llamada, o esta superaría el límite mensual propio de la clave. También se devuelve en la llamada de propuesta de asignación de la API de carga de datos.	No vuelvas a intentarlo. Espera hasta reset_at, añade créditos o aumenta el límite de la clave.
rate_limited	error	5	Se ha alcanzado el límite de solicitudes por minuto de la clave. También ocurre cuando hay demasiados intercambios de sesión para una clave, un mapa publicado o una dirección.	Espera los segundos indicados en Retry-After y vuelve a intentarlo con una variación aleatoria del retraso.
org_overloaded	error	5	Tu organización tiene demasiadas llamadas ejecutándose al mismo tiempo.	Espera a que termine una llamada y vuelve a intentarlo. Cierra los flujos de respuesta que ya no necesites.
b2b_overloaded	error	5	La API ha alcanzado su capacidad máxima para todos los usuarios.	Espera los segundos indicados en Retry-After y reintenta aplicando esperas progresivamente mayores.
limiter_unavailable	error	5	El limitador de solicitudes no ha podido responder.	Vuelve a intentarlo en breve. No se debe a tu frecuencia de solicitudes.
visitor_limit_reached	error	5	Un visitante del chat de un mapa publicado ha superado el límite de solicitudes por minuto o por día.	Indica al visitante que lo intente de nuevo más tarde.
map_load_quota_exceeded	detail	ninguno	POST /sdk/sessions para tile: se ha agotado el cupo de cargas de mapas de la organización.	No vuelvas a intentarlo. Espera al restablecimiento del período o añade un paquete de cargas de mapas.

El cuerpo de quota_exceeded incluye los valores numéricos:

{
  "error": "quota_exceeded",
  "detail": "Usage limit reached. Please try again later.",
  "product": "b2b",
  "meter": "b2b.tokens",
  "tier": "pro",
  "limit": 5000000,
  "used": 4999100,
  "remaining": 900,
  "reset_at": "2026-11-01T04:00:00+00:00",
  "period": "month",
  "reset_in_seconds": 1296000
}

Ese es el cuerpo que recibe una clave de servidor. Una solicitud hecha con un token de sesión (procedente de una clave publicable o de una sesión de visitante de un mapa publicado) recibe un cuerpo más breve que no revela el plan ni el consumo de la organización:

{
  "error": "quota_exceeded",
  "detail": "Usage limit reached. Please try again later.",
  "meter": "b2b.tokens",
  "reset_at": "2026-11-01T04:00:00+00:00",
  "reset_in_seconds": 1296000
}

Cada campo, la variante del límite por clave y el código de ejemplo para gestionarlo están en Cuotas y límites de frecuencia.

Errores del servidor: 5xx

Estado	Código	Cuándo ocurre	Qué hacer
500	An internal error occurred. Please try again.	Error inesperado.	Reintente una vez tras una breve pausa.
500	map_design_analyze_failed	POST /design/analyze no pudo analizar la tabla. No se cobra.	Compruebe las columnas y las filas de ejemplo de la tabla y vuelva a intentarlo.
500	Summary stream error	POST /chat/summary/stream no pudo comenzar: el cuerpo no se puede leer o una solicitud sobre un edificio no contiene address. Un campo demasiado largo devuelve 422 field_too_long en su lugar.	Corrija el cuerpo.
500	Button chat stream error	POST /chat/button/stream no pudo comenzar: el cuerpo no se puede leer o no contiene query. Un campo demasiado largo devuelve 422 field_too_long en su lugar.	Corrija el cuerpo.
503	sessions_not_configured	El intercambio de sesiones no está disponible por un fallo de la plataforma.	Reintente; contacte con soporte si persiste.
503	share_grant_unavailable	Intercambio de mapa publicado: no se pudieron leer los ajustes del mapa.	Reintente en breve.

Error con estado 200

POST /chat/control/route devuelve 200 cuando no se puede planificar una ruta:

{ "error": "Route planning failed." }

La respuesta contiene error y no contiene action. Un cliente que solo comprueba el estado interpreta esto como un éxito y luego falla al intentar leer action. Compruebe siempre si existe error en el cuerpo. El mensaje está redactado para mostrarse al usuario. Detalles: Indicaciones.

GET /retrieval/geocode/forward tiene un comportamiento parecido: una búsqueda que falla internamente devuelve 200 con una lista results vacía, igual que una consulta sin coincidencias.

Errores en un flujo

Todo lo anterior se aplica antes de que comience un flujo: una solicitud de streaming rechazada produce un error HTTP normal. Una vez que la respuesta es 200 y se transmiten mensajes, los fallos llegan como un evento error:

event: error
data: {"type": "error", "code": "upstream_stall", "message": "The AI service stopped responding. Please try again.", "partial_text": "The Louvre sits"}

Flujo	code	Cuándo ocurre	Qué hacer
/chat/control/stream	upstream_stall	La respuesta dejó de avanzar o el flujo alcanzó su duración máxima de unos 10 minutos.	Ofrezca volver a intentarlo. Conserve partial_text si resulta útil.
/chat/control/stream	ausente	Cualquier otro fallo al responder.	Muestre message. Un reintento puede funcionar.
/chat/summary/stream	ausente	Falló el resumen.	Muestre message o continúe sin resumen.
/spot/overview/stream	ausente	Falló la descripción general o no es posible describir el ref. El evento incluye ref cuando no se puede describir: una referencia poi: o region: que no corresponde al punto, place: sin hint.name o un edificio o dirección, que la API no describe.	No muestre descripción general. No reintente un evento que incluya ref.
/chat/button/stream	ninguno	Este flujo no tiene evento error. Ante un fallo, se cierra la conexión sin end.	Considere fallido un flujo que termina sin end.

Reglas aplicables a todos los flujos:

• Un evento error sustituye a end. Después solo puede llegar un evento quota opcional.
• Una conexión que termina sin end ni error ha fallado.
• El evento quota no es un error. Es un informe de consumo enviado después de end o error. En un flujo leído mediante un token de sesión solo contiene type, meter y reset_at.
• Un nombre de evento desconocido no es un error. Ignórelo.

Un flujo que falla o se cierra antes de terminar también se cobra. En /chat/control/stream, el cargo nunca es inferior a una estimación del tamaño de la conversación enviada, por lo que puede superar la reserva inicial: consulte Cómo se cobra un flujo. Un reintento es una solicitud nueva con un cargo independiente.

Errores que oculta el navegador

Cuando se rechazan el origen o las credenciales, la respuesta carece de cabecera CORS y el navegador oculta el estado y el cuerpo a su código. La página ve un error CORS en la consola y una promesa fetch rechazada; el SDK registra un error que contiene [kaleidr:<product>].

Para conocer el código real, abra la pestaña Network y seleccione la solicitud fallida. Los más frecuentes son origin_not_allowed, Invalid or missing API key y server_key_in_browser. Consulte CORS y orígenes permitidos.

Una respuesta 4xx sin cuerpo JSON de Kaleidr procede del borde de la red, antes de llegar a la API. Se debe a un límite de frecuencia (espere y reintente más tarde) o a que el tamaño declarado de la solicitud supera ampliamente el límite de cualquier endpoint (envíe menos datos; repetir la misma solicitud dará el mismo resultado).

Servidor de teselas

Las solicitudes a tile.kaleidr.com que no procedan de un embed de Kaleidr con una clave publicable válida y un origen permitido reciben:

Estado	Código	Retry-After	Qué hacer
429	tile_access_restricted (en error, con message y docs)	3600	Use el producto Tile con una clave publicable y, si la clave tiene una lista de orígenes permitidos, añada el origen de la página.

Administración de claves

Errores de https://api.kaleidr.com/shared-api/api-keys, que utiliza la página API Keys y a la que puede llamar con el token de acceso de su cuenta. Todos tienen el formato envuelto.

Estado	Código	Cuándo ocurre	Qué hacer
401	variable	No hay un token de acceso válido de la cuenta. No se acepta aquí una clave de plataforma.	Inicie sesión de nuevo.
403	org_admin_required	Su cuenta no pertenece a un propietario o administrador de la organización.	Consulte con un propietario o administrador.
403	plan_required	La organización no tiene un plan.	Elija uno en kaleidr.com/billing.
403	free_plan_publishable_only	Se solicitó una clave de servidor en Free. También ocurre al rotar una clave de servidor o heredada en Free.	Cree una clave publicable o cambie a Pro.
403	tier_capability_not_allowed	Al crear una clave, scopes o allowed_products nombra un elemento no permitido por el plan. En la práctica, suele ser vendor en Free o Pro; se rechaza haya o no vendor_acknowledged, sin crear ninguna clave. Al editar, allowed_products nombra un producto que el plan no incluye o, en Free, se establece en una lista vacía.	vendor requiere Enterprise. Para lo demás, use permisos y productos admitidos por el plan.
404	key_not_found	No existe una clave con ese identificador en la organización. La edición y revocación encuentran claves de cualquier estado, por lo que revocar una ya revocada devuelve 200. La rotación requiere una clave activa y devuelve este código si está revocada.	Compruebe el identificador. Para una rotación, es posible que la clave esté revocada.
409	key_limit_reached	La organización alcanzó el límite de claves activas del plan (Free 2, Pro 10, Enterprise 25).	Revoque una clave o rote una existente en vez de crear otra.
409	key_already_rotated	La clave ya se rotó, haya terminado o no el período de gracia. No puede rotarse otra vez y se rechaza editarla para borrar expires_at o fijarlo después del final del período de gracia. Puede modificarse un expires_at anterior y el resto de campos.	Use la clave de reemplazo.
409	key_expired	Una clave que nunca se rotó ha superado su fecha de caducidad y la edición incluye expires_at. No se puede asignar una nueva caducidad a una clave caducada, pero sí editar sus otros campos.	Cree una clave nueva.
413	request_body_too_large	El cuerpo supera 1 MiB.	Envíe un cuerpo más pequeño.
422	unknown_scope	scopes contiene algún valor distinto de ai, maps, design, vendor.	Corrija la lista.
422	unknown_product	allowed_products contiene un valor distinto de chat, editor, viewer, tile.	Corrija la lista.
422	vendor_scope_requires_acknowledgement	En Enterprise se pidió una clave publicable con el permiso vendor sin vendor_acknowledged: true. En Free y Pro, la misma petición devuelve 403 tier_capability_not_allowed.	Lea el permiso vendor y envíe el campo.
422	no_fields_to_update	Solicitud de edición sin campos editables.	Envíe al menos un campo.
422	lista de validación	Un origen, entrada IP, caducidad en el pasado o nombre con formato incorrecto.	Corrija el campo identificado por loc.
500	insert_failed, session_unavailable	Fallo de la plataforma.	Reintente.
503	api_key_pepper_not_configured	No pueden crearse claves debido a un fallo de la plataforma.	Reintente; contacte con soporte si persiste.

Carga de datos empresariales

Errores de las rutas de carga en https://api.kaleidr.com/shared-api/datahub y de la llamada de propuesta de asignación. La lista completa, con los límites de archivos y campos que provocan cada 422, está en Cargar sus datos empresariales. Aquí se muestran los errores que rechazan una solicitud antes de leer el archivo y los de las llamadas para retirar la publicación o eliminar una versión:

Estado	Código	Cuándo ocurre	Qué hacer
403	org_admin_required	La cuenta no pertenece a un propietario ni administrador de la organización. También lo devuelve la propuesta de asignación.	Consulte con un propietario o administrador.
403	vendor_data_not_on_plan	El plan de la organización no permite cargar datos empresariales. La carga solo está incluida en Enterprise. Lo devuelven carga, publicación, nuevo procesamiento y propuesta de asignación. Nunca se devuelve al leer, retirar una publicación o eliminar.	Cambie a Enterprise. GET /shared-api/datahub/limits indica, en cualquier plan y sin rechazar la solicitud, si la organización puede cargar datos. En Free y Pro, añada datos a un mapa en Kaleidr Studio: consulte Conjuntos de datos en un mapa.
404	release_not_found	Al retirar o eliminar, no hay ninguna versión con ese identificador en la organización, incluida una cuyo borrado ya finalizó.	En una eliminación, considérela ya realizada.
409	org_ingest_in_progress	Se está procesando otra carga de la organización. Lo devuelven carga, publicación y nuevo procesamiento.	Espere a que termine y envíe de nuevo.
409	release_not_published	Se pidió retirar la publicación de un borrador o una versión fallida.	No hay nada que retirar. Elimínela.
409	release_is_published	Se intentó eliminar la versión publicada.	Retire su publicación y después elimínela.
413	request_body_too_large	La solicitud de carga supera los 32 MiB.	Envíe un archivo más pequeño. El archivo en sí puede alcanzar el límite de tamaño de su organización.
422	{ "errors": [ … ] } en detail	El archivo supera un límite de filas o tamaño, un campo del paquete JSON supera su longitud máxima o el JSON tiene demasiados niveles de anidación. La razón de un límite contractual especifica el límite y el plan.	Lea cada motivo y corrija el archivo.
429	ingest_rate_limited	La organización inició 30 cargas durante la última hora.	Espere y vuelva a enviar.
429	una frase en detail	La cuenta realizó 30 propuestas de asignación durante la última hora. El cuerpo no contiene el campo error.	Espere y vuelva a enviar.
429	quota_exceeded en error	Propuesta de asignación: se agotaron los créditos de IA de la organización. El cuerpo es la respuesta estándar de cuota.	Espere hasta reset_at, añada créditos o escriba la asignación manualmente.

Carga de conjuntos de datos en Kaleidr Studio

Esta sección no forma parte de la API de plataforma autenticada por clave. Describe lo que recibe Kaleidr Studio cuando un usuario con sesión iniciada añade un conjunto de datos a un mapa desde el panel Data y la carga es rechazada por su tamaño. No interviene ninguna clave API. Existen dos rechazos con significados distintos:

Estado	Código	Cuándo ocurre	Qué hacer
402	quota_exceeded	La carga de un conjunto de datos nuevo supera uno de los límites del plan de la organización: filas por conjunto, tamaño de un archivo o filas de todos los conjuntos de la organización. limit_key identifica el límite. Se conservan los datos ya almacenados. Studio muestra el mensaje y un enlace para cambiar de plan.	Cargue un archivo menor o elimine conjuntos que ya no necesite. En Free, cambie a Pro. En Pro o Enterprise, contacte con Kaleidr para un total mayor en la organización; los límites de filas por conjunto y tamaño de archivo no pueden superar los máximos de la fila siguiente.
400	VALIDATION_ERROR	El archivo o conjunto de datos supera un límite máximo que se aplica a todos los planes: archivo mayor de 64 MiB, conjunto de más de 100.000 filas, archivo geográfico con más de 50.000 elementos o imagen superpuesta de más de 16 MiB. El código está en error. Cambiar de plan no permitirá esa carga.	Divida el archivo en otros más pequeños. No reintente el mismo archivo ni ofrezca un cambio de plan.

La respuesta depende del tamaño y no solo del plan. Primero se comprueba el límite máximo general; por ello, un archivo de más de 64 MiB o un conjunto de más de 100.000 filas devuelve 400 por igual en Free, Pro y Enterprise. El 402 se aplica cuando la carga no supera el máximo general, pero sí el límite de su organización; por ejemplo, un archivo de 40 MiB en Free, cuyo límite es 32 MiB.

402 quota_exceeded

El cuerpo es un objeto de detalles del problema que también incluye los campos propios de Studio error y message. El código aparece tanto en error como en code, y la frase tanto en message como en detail:

{
  "error": "quota_exceeded",
  "message": "Your plan allows 250,000 rows across all of your organization's datasets. Delete a dataset or upgrade to add more.",
  "type": "https://errors.kaleidr.com/datasets/quota_exceeded",
  "title": "Quota Exceeded",
  "status": 402,
  "detail": "Your plan allows 250,000 rows across all of your organization's datasets. Delete a dataset or upgrade to add more.",
  "code": "quota_exceeded",
  "limit_key": "studio.data.rows.max",
  "limit": 250000,
  "used": 248500,
  "tier": "free",
  "upgrade_url": "https://kaleidr.com/pricing"
}

Campo	Significado
error, code	Siempre quota_exceeded. El mismo valor dos veces.
message, detail	La misma frase dos veces. Indica el límite en términos sencillos y está pensada para mostrarse al usuario.
type	Siempre https://errors.kaleidr.com/datasets/quota_exceeded.
title	Siempre Quota Exceeded.
status	Siempre 402.
limit_key	El límite que rechazó la carga. Véase la tabla siguiente.
limit	El límite de la organización, en la unidad correspondiente.
used	Para el total, las filas ya almacenadas por la organización. Para los otros dos, las filas o los MiB de esta carga.
tier	El plan de la organización: free, pro o enterprise. Es unknown si no puede leerse el plan; entonces se aplican los límites de Free.
upgrade_url	Dónde cambiar el plan.

limit_key	Límite	Unidad de limit y used	Frase
studio.dataset.rows.max	Filas de un conjunto de datos	Filas	«Su plan permite 50.000 filas por conjunto de datos. Cargue un archivo menor o cambie de plan».
studio.dataset.file.mb	Tamaño de un archivo cargado	MiB	«Su plan permite archivos de hasta 32 MB. Cargue un archivo menor o cambie de plan».
studio.data.rows.max	Filas de todos los conjuntos de la organización	Filas	«Su plan permite 250.000 filas en todos los conjuntos de datos de su organización. Elimine un conjunto o cambie de plan para añadir más».

Las cifras de estas frases corresponden a los límites de Free; la frase recibida contiene los de su organización. Muestre la frase al usuario y tome decisiones según code y limit_key. Este 402 es distinto del 429 quota_exceeded de la API de plataforma, que se refiere a créditos de IA.

400 VALIDATION_ERROR

El cuerpo contiene dos campos y ningún dato adicional de detalles del problema:

{
  "error": "VALIDATION_ERROR",
  "message": "File is larger than 64 MB."
}

Motivo del rechazo	message
Archivo mayor de 64 MiB	«El archivo supera los 64 MB».
Conjunto de más de 100.000 filas	«Máximo de 100000 registros por conjunto de datos».
Archivo geográfico con más de 50.000 elementos	«<filename> contiene más de 50000 elementos. Divida el archivo o simplifique la geometría antes de cargarlo».
Imagen superpuesta mayor de 16 MiB	«La imagen superpuesta supera los 16 MB».

El mismo estado y código se devuelven por otros problemas con un archivo cargado, como un tipo de archivo que Studio no puede leer o un archivo sin filas utilizables; message indica el motivo. Trate cualquier 400 de una carga como «este archivo no se puede añadir tal como está» y muestre message.

Temas relacionados

• Autenticación y permisos: credenciales e intercambio de sesiones.
• Cuotas y límites de frecuencia: detalles de las respuestas 429.
• Contrato de eventos SSE: eventos de un flujo.
• Solución de problemas: problemas según sus síntomas.