Saltar al contenido principal

​
Códigos de error

Los errores de la API de Fetch Hive incluyen un message legible para humanos, un error_code estable y error como alias de compatibilidad para el mismo mensaje. Las respuestas más antiguas de plan y límite de tasa también pueden incluir code; trata code como un alias obsoleto y lee error_code primero. Rails es el dueño del catálogo de códigos de error, así como de las plantillas de mensajes localizados y de acciones del cliente. Las respuestas de la API con alcance de cuenta usan el ajuste de idioma de la cuenta autenticada al devolver el texto. Los errores de validación/preflight generados por Rust usan el mismo sobre JSON y localizan sus campos error/message legibles a partir del idioma de la cuenta autenticada, recurriendo al inglés. Los nuevos códigos de error orientados a la API deben agregarse al catálogo de Rails; las constantes de Rust y React se verifican contra esa fuente. Usa GET /v1/error_codes para recuperar el catálogo público. El endpoint no requiere autenticación porque devuelve metadatos estáticos del contrato de la API. Pasa ?locale=es para solicitar el texto del catálogo en español; los idiomas no soportados o no disponibles recurren al inglés. 
{
  "locale": "en",
  "default_field": "error_code",
  "compatibility_aliases": ["code"],
  "codes": [
    {
      "code": "model_deprecated",
      "status": 422,
      "field": "error_code",
      "message_key": "errors.codes.model_deprecated",
      "message": "The selected model \"%{model}\" is no longer available. Choose a current model and try again.",
      "field_aliases": [],
      "category": "runtime",
      "client_action_key": "errors.client_actions.model_deprecated",
      "client_action": "Choose an active model and retry."
    }
  ]
}

​
Forma del error en JSON

{
  "error": "The selected model \"old-model\" is no longer available. Choose a current model and try again.",
  "message": "The selected model \"old-model\" is no longer available. Choose a current model and try again.",
  "error_code": "model_deprecated"
}

​
Forma del error en SSE

Los endpoints de streaming envían errores como Server-Sent Events con type: "error". 
{
  "type": "error",
  "error": "Provider request failed",
  "message": "Provider request failed",
  "error_code": "provider_error",
  "error_type": "provider_error",
  "status_code": 502
}

​
Códigos

CódigoCampoEstadoSignificadoAcción del cliente
model_deprecatederror_code422El prompt guardado, agente, paso de flujo de trabajo, despliegue o modelo de respaldo ya no está disponible.Elige un modelo activo y reintenta.
personal_model_missing_credentialserror_code422Una ejecución de modelo personal necesita credenciales del proveedor que no están conectadas.Conecta las credenciales o cambia a un modelo alojado/actual.
personal_model_invalid_credentialserror_code422Las credenciales del proveedor estaban presentes pero fueron rechazadas por el proveedor.Vuelve a conectar o rota la credencial del proveedor.
insufficient_hosted_llm_creditserror_code402El espacio de trabajo no tiene suficientes créditos de LLM alojado para la ejecución.Agrega créditos, actualiza el plan o usa una clave de proveedor personal.
account_credit_cap_reachederror_code422La cuenta alcanzó su tope general de créditos.Actualiza el plan o espera más créditos antes de reintentar.
asset_storage_limit_reachederror_code402El espacio de trabajo alcanzó su límite de almacenamiento de activos.Elimina activos o actualiza el plan del espacio de trabajo.
vision_not_supportederror_code422El modelo seleccionado no puede procesar entradas de imagen.Selecciona un modelo con capacidad de visión o elimina las entradas de imagen.
workflow_step_limit_reachederror_code402El flujo de trabajo alcanzó el límite de pasos del plan.Elimina pasos o actualiza el plan.
workspace_limit_reachederror_code402La cuenta alcanzó el límite de espacios de trabajo del plan.Elimina un espacio de trabajo o actualiza el plan.
api_rate_limit_exceedederror_code429La clave de API alcanzó su tope diario de solicitudes.Reintenta después del reinicio o actualiza el plan.
log_range_limit_exceedederror_code402El rango de registros solicitado es mayor que la ventana permitida.Reduce el rango de fechas.
iteration_limit_exceedederror_code422Una iteración de flujo de trabajo excedió el número de bucles permitido.Reduce el tamaño de la entrada o la cantidad de iteraciones.
internal_server_errorerror_code500Fetch Hive encontró un error interno inesperado.Reintenta más tarde; contacta a soporte si persiste.
too_many_requestserror_code429Un proveedor o Fetch Hive rechazó la solicitud debido al límite de tasa.Aplica backoff y reintenta.
concurrency_limit_reachederror_code429La cuenta alcanzó su límite de concurrencia de flujos de trabajo activos.Reintenta más tarde o usa entrega por callback.
validation_errorerror_code400/422La API pública de Rust rechazó los parámetros de la solicitud antes del despacho.Corrige el cuerpo o los parámetros de consulta de la solicitud.
unsupported_providererror_code400El proveedor configurado no es compatible con esa ruta de runtime.Selecciona un proveedor/modelo soportado.
database_errorerror_code500La API pública de Rust no pudo completar una operación de base de datos.Reintenta más tarde; contacta a soporte si persiste.
config_errorerror_code500La configuración de runtime estaba ausente o era inválida.Contacta a soporte.
provider_errorerror_code502Un proveedor de modelos rechazó o falló la solicitud.Verifica el estado/entrada del proveedor y reintenta.
upstream_request_failederror_code502/504Rust no pudo obtener una respuesta exitosa de Rails u otro runtime ascendente.Reintenta más tarde; contacta a soporte si persiste.
workflow_enqueue_failederror_code500No se pudo encolar una ejecución de flujo de trabajo.Reintenta la ejecución del flujo de trabajo.
not_founderror_code404El recurso solicitado no fue encontrado para la cuenta autenticada.Verifica el identificador y el contexto de la cuenta.
resource_not_founderror_code404No se encontró un recurso de Rails con nombre.Verifica el identificador y el contexto de la cuenta.
invalid_accesserror_code401La solicitud del panel o pública no está autenticada para la cuenta solicitada.Inicia sesión nuevamente y reintenta.
unauthorizederror_code401Una solicitud interna, del panel o de servicio carece de autorización válida.Inicia sesión nuevamente y reintenta.
forbiddenerror_code403El llamador está autenticado pero no tiene permitido realizar la acción.Usa una cuenta con acceso o contacta a un administrador.
invalid_api_keyerror_code401Una solicitud global o autenticada por clave de API usó una clave inválida.Verifica la clave de API y reintenta.
invalid_requesterror_code400Un campo de la solicitud es inválido.Corrige la solicitud y reintenta.
missing_required_fielderror_code422Falta un campo requerido en la solicitud.Proporciona el campo requerido y reintenta.
missing_required_headererror_code400Falta un encabezado requerido en la solicitud.Envía el encabezado requerido y reintenta.
validation_failederror_code422Falló la validación de Rails; los detalles se devuelven en errors o details.Corrige los campos resaltados y reintenta.
payment_failederror_code422Falló un flujo de pago de Stripe.Verifica el método de pago y reintenta.
billing_configuration_missingerror_code422Un plan o ruta de facturación solicitada carece de configuración de Stripe del lado del servidor.Contacta a soporte.
stripe_customer_creation_failederror_code422Fetch Hive no pudo crear ni cargar el cliente de Stripe para la cuenta.Reintenta más tarde; contacta a soporte si persiste.
promotion_code_invaliderror_code200Un código de descuento está ausente, es inválido, ha expirado o fue rechazado por Stripe.Verifica el código de descuento y reintenta.
archive_restore_conflicterror_code409Ya hay una restauración de archivo en ejecución para la cuenta.Espera a que termine la restauración existente antes de reintentar.
completion_resolution_failederror_code500Fetch Hive no pudo resolver una completación a su URL del panel.Reintenta más tarde; contacta a soporte si persiste.
integration_connection_failederror_code502No se pudo iniciar ni sincronizar la conexión de una integración.Vuelve a conectar la integración y reintenta.
webhook_signature_invaliderror_code400No se pudo verificar la firma de un webhook.Verifica el secreto de firma del webhook y reintenta.
webhook_signature_not_configurederror_code500Falta un secreto de firma de webhook en el servidor.Configura el secreto de firma del webhook antes de reintentar.
webhook_payload_invaliderror_code400No se pudo analizar la carga útil del webhook.Envía una carga útil de webhook válida.
mcp_connection_failederror_code422Falló la prueba de un servidor MCP del espacio de trabajo.Verifica la URL del servidor MCP, la autenticación y el formato de respuesta.
unsupported_resource_typeerror_code400El tipo de recurso solicitado no es compatible.Usa un tipo de recurso soportado.
Para workflow_step_limit_reached, workspace_limit_reached, api_rate_limit_exceeded y log_range_limit_exceeded, las respuestas también pueden incluir code con el mismo valor para clientes más antiguos.