Mariner GPS Tools Geliştirici Platformu

Genel bakış ve hızlı başlangıç

Mariner GPS Tools'a güç veren test edilmiş seyir hesaplayıcılarını JSON REST API veya Model Context Protocol sunucusu üzerinden kullanın.

REST veya MCP'yi seçin

Her iki arayüz de aynı hesaplama motorunu ve izin modelini kullanır. Her isteği kontrol ettiğiniz uygulamalar ve komut dosyaları için API anahtarıyla REST'i kullanın. Bir yapay zekâ asistanının veya aracısının mevcut araçları keşfetmesi, şemalarını anlaması ve doğru hesaplamayı kendisi seçmesi gerektiğinde MCP'yi kullanın.

REST API

Doğrudan, sürümlendirilmiş istekler

Uygulamalardan, hizmetlerden, otomasyonlardan ve komut dosyalarından gezinme hesaplamalarını çağırın.

https://marinergps.tools/api/v1

MCP sunucusu

Yapay zeka aracılarına yönelik araçlar

MCP uyumlu aracıların mevcut yetenekleri keşfetmesine ve uygun hesaplamayı seçmesine izin verin.

https://marinergps.tools/mcp

Kimlik doğrulama

İki oturum açma yöntemi de aynı hesaplama motoruna ulaşır. Etkileşimli yapay zekâ istemcileri MCP sunucusuna bağlanır ve erişimi tarayıcıda OAuth ile yetkilendirir. Uygulamalar, hizmetler, komut dosyaları ve manuel entegrasyonlar, Bearer belirteci olarak gönderilen bir Mariner GPS Tools API anahtarı kullanır. Anahtarlar ücretsiz oluşturulabilir ve istediğiniz zaman döndürülebilir veya iptal edilebilir.

API anahtarı oluşturun

Authorization başlığıhttp

Authorization: Bearer mrt_live_...

REST hızlı başlangıç

API anahtarınızı kullanarak herhangi bir sürüme sahip REST uç noktasına bir JSON isteği gönderin. Yanıtlar tutarlı bir şekilde kullanılırok, data, veerrortüm hesaplama araçlarındaki yapı.

Bir yön hesaplayınshell

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 hızlı başlangıç

Sunucu URL'sini uyumlu bir yapay zekâ istemcisine ekleyin ve Mariner Tools yetkilendirme sayfası açıldığında tarayıcınızda erişimi onaylayın. İstemci, oturum açma kurulumunu ve kullanılabilir araçları otomatik olarak keşfeder; kopyalanacak anahtar veya belirteç yoktur.

Sunucu URL'sihttp

https://marinergps.tools/mcp

Adım adım kurulum kılavuzu

Alternatif: API anahtarıyla manuel yapılandırma

Tarayıcı yetkilendirmesi olmayan istemciler ve programatik entegrasyonlar bunun yerine bir API anahtarı gönderebilir:

MCP istemci yapılandırmasıjson

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

REST yanıt formatı

Başarılı REST yanıtları hesaplanan sonucu döndürürdata. Doğrulama ve istek hataları, insan tarafından okunabilen bir mesajın yanı sıra makine tarafından okunabilen kararlı bir hata kodu döndürür.

JSON

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

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