Plataforma de desarrollador Mariner GPS Tools

Límites y validación

Las llamadas públicas a la API y MCP tienen límites de frecuencia. Las entradas se validan antes del cálculo, incluidas las unidades de velocidad compatibles, los valores numéricos finitos y los intervalos de latitud o longitud.

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, valores numéricos finitos, campos inesperados y rangos válidos de latitud y longitud.

Í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 Mariner GPS 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.