Mariner GPS Tools Developer Platform

Limits and validation

Mariner GPS Tools validates requests before calculation and returns consistent, machine-readable errors when a request cannot be completed.

Request limits

JSON request bodies are limited to16 KiB. Inputs are validated before calculation, including supported units, finite numeric values, unexpected fields, and valid latitude and longitude ranges.

Public API index

GET /api/v1is available without authentication and provides basic API information. Tool discovery, calculations, and MCP requests require a valid API key.

Errors

REST errors return a stable machine-readable code alongside a human-readable message. MCP transport errors use JSON-RPC formatting and include the Mariner GPS Tools error code inerror.data.code.

REST errorjson

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

400invalid_requestThe request body or one of its fields is invalid.

401unauthorizedThe API key is missing, malformed, revoked, or not recognised.

403forbiddenThe API key does not have the required scope.

404not_foundThe requested endpoint does not exist.

413payload_too_largeThe request body exceeds 16 KiB.

415unsupported_media_typeThe endpoint requires an application/json request.

429rate_limitedThe request limit has been reached. Try again shortly.

500internal_errorThe service could not complete the request.