Plataforma de agentes y API Road User Tools

Límites y validación

Road User Tools valida las solicitudes antes del cálculo y devuelve errores coherentes y legibles por máquina cuando una solicitud no se puede completar.

Límites de solicitud

Los cuerpos de solicitud JSON se limitan a16 KiB. Las entradas se validan antes del cálculo, incluidas las unidades admitidas, los valores numéricos finitos, los campos inesperados y los intervalos de valores, como las distancias no negativas.

Índice público API

GET /api/v1está disponible sin autenticación y proporciona información básica sobre API. El descubrimiento de herramientas, los cálculos y las solicitudes de MCP requieren una clave API válida.

Errores

Los errores REST devuelven un código estable legible por máquina junto con un mensaje legible por humanos. Los errores de transporte MCP utilizan el formato JSON-RPC e incluyen el código de error Road User Tools enerror.data.code.

Error RESTjson

{
  "ok": false,
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again shortly."
  }
}

400invalid_requestEl cuerpo de la solicitud o uno de sus campos no es válido.

401unauthorizedLa clave API falta, está mal formada, está revocada o no se reconoce.

403forbiddenLa clave API no tiene el alcance requerido.

404not_foundEl punto final solicitado no existe.

413payload_too_largeEl cuerpo de la solicitud excede 16 KiB.

415unsupported_media_typeEl punto final requiere un application/json solicitud.

429rate_limitedSe ha alcanzado el límite de solicitudes. Vuelve a intentarlo en breve.

500internal_errorEl servicio no pudo completar la solicitud.