Pangkalahatang-ideya at mabilisang pagsisimula

Piliin ang REST o MCP

Ang parehong interface ay gumagamit ng parehong calculation engine at modelo ng pahintulot. Gamitin ang REST na may API key para sa mga application at script kung saan mo kinokontrol ang bawat kahilingan. Gamitin ang MCP kapag dapat matuklasan ng isang AI assistant o agent ang mga available na tool, maunawaan ang kanilang mga schema, at piliin mismo ang tamang kalkulasyon.

Authentication

Dalawang paraan ng pag-sign in ang umaabot sa parehong calculation engine. Ang mga interactive na AI client ay kumokonekta sa MCP server at nagpapahintulot ng access sa browser gamit ang OAuth. Ang mga application, serbisyo, script, at manual na integration ay gumagamit ng Mariner GPS Tools API key na ipinapadala bilang Bearer token. Libre ang paggawa ng mga key at maaari itong i-rotate o bawiin anumang oras.

Authorization: Bearer mrt_live_...

REST quickstart

Magpadala ng JSON na kahilingan sa anumang bersyon na REST endpoint gamit ang iyong API key. Gumagamit ng pare-pareho ang mga tugonok, data, aterroristraktura sa lahat ng mga tool sa pagkalkula.

curl -X POST https://marinergps.tools/api/v1/bearing \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "from": { "lat": 50.1, "lng": -4.2 },
    "to": { "lat": 49.8, "lng": -3.1 }
  }'

MCP quickstart

Idagdag ang URL ng server sa isang compatible na AI client at aprubahan ang access sa iyong browser kapag bumukas ang authorization page ng Mariner Tools. Awtomatikong natutuklasan ng client ang sign-in setup at ang mga available na tool, nang walang key o token na kailangang kopyahin.

https://marinergps.tools/mcp

Alternatibo: manual na configuration gamit ang API key

Ang mga client na walang authorization sa browser, at mga programmatic na integration, ay maaaring magpadala ng API key sa halip:

{
  "mcpServers": {
    "mariner-tools": {
      "url": "https://marinergps.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

REST na format ng tugon

Ibinabalik ng mga matagumpay na tugon ng REST ang kinakalkula na resulta sadata. Ang mga pagkabigo sa pagpapatunay at kahilingan ay nagbabalik ng isang matatag na code ng error na nababasa ng makina kasama ng isang mensaheng nababasa ng tao.

{
  "ok": true,
  "data": {
    "degrees": 112.7,
    "compass": "ESE"
  }
}

{
  "ok": false,
  "error": {
    "code": "invalid_request",
    "message": "Invalid bearing input."
  }
}