Geliştiriciler: API, Claude ve ChatGPT

Legalitify’ın uyum ön tarama motorunu kendi yazılımınıza, Claude’a ve ChatGPT’ye bağlayabilirsiniz: web sitesi taraması başlatma, tarama durumunu ve raporu alma, PDF bağlantısı üretme, reklam/içerik metni kontrolü ve düzeltilmiş metin isteme.

• 1. API anahtarı alma
• 2. REST API ve curl örnekleri
• 3. Claude’a bağlama (MCP)
• 4. ChatGPT’ye bağlama (GPT Actions)
• 5. Yetkiler (kapsamlar)
• 6. Paket sınırları
• 7. Hata kodları
• 8. Güvenlik ve webhook

1. API anahtarı alma

1. Ücretsiz hesap açın veya giriş yapın.
2. Panelde API Anahtarları sayfasına gidin (https://legalitify.com/user/api-keys).
3. Anahtara bir ad verin (ör. “Claude Code”), gereken yetkileri seçin, Oluştur’a basın.
4. Anahtar (legk_live_…) yalnız bir kez gösterilir; güvenli bir yere kaydedin. Sistemde yalnız özeti (SHA-256) saklanır; kaybederseniz iptal edip yenisini oluşturun.

Test için sandbox anahtarı (legk_test_…) oluşturabilirsiniz: kredi düşmez, sabit örnek yanıt döner.

2. REST API ve curl örnekleri

Kök adres: https://legalitify.com/api/kyl/v1 · OpenAPI 3.1 şeması: /api/kyl/v1/openapi.json

Kimlik doğrulama: her istekte Authorization: Bearer ANAHTARINIZ başlığı. (Eski entegrasyonlar X-KYL-Key başlığını da kullanabilir.) Anahtarı asla URL’ye/sorgu dizesine koymayın.

Web taraması: başlat → durum sorgula → rapor

Tarama birkaç dakika sürer. Başlatınca scan_id döner; is_terminal true olana dek yaklaşık 20 saniyede bir durumu sorgulayın.

curl -X POST https://legalitify.com/api/kyl/v1/scans \
  -H "Authorization: Bearer ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"domain":"ornek.com.tr"}'
# → 202 {"ok":true,"scan_id":1234,"status":"queued","poll_after_seconds":20,...}

curl -H "Authorization: Bearer ANAHTARINIZ" https://legalitify.com/api/kyl/v1/scans/1234
# → {"status":"analyzing","is_terminal":false,...}  sonra  {"status":"completed","is_terminal":true,"overall_score":72.5}

curl -H "Authorization: Bearer ANAHTARINIZ" "https://legalitify.com/api/kyl/v1/reports/1234?severity=critical&limit=20"
curl -H "Authorization: Bearer ANAHTARINIZ" https://legalitify.com/api/kyl/v1/reports/1234/pdf
# → {"pdf_url":"…(süreli imzalı bağlantı)…","web_report_url":"…","expires_at":"…"}

Reklam / içerik metni kontrolü ve düzeltme

curl -X POST https://legalitify.com/api/kyl/v1/check-content \
  -H "Authorization: Bearer ANAHTARINIZ" -H "Content-Type: application/json" \
  -d '{"text":"Bu krem 7 günde kırışıklıkları %100 yok eder!","sector":"cosmetics"}'

curl -X POST https://legalitify.com/api/kyl/v1/fix \
  -H "Authorization: Bearer ANAHTARINIZ" -H "Content-Type: application/json" \
  -d '{"text":"Bu krem 7 günde kırışıklıkları %100 yok eder!","sector":"cosmetics"}'

3. Claude’a bağlama (MCP)

Legalitify bir uzak MCP sunucusudur (Streamable HTTP). Adres: https://legalitify.com/mcp

Araçlar: legatify_scan_site (tarama başlat), legatify_scan_status, legatify_list_scans, legatify_get_report (özet + bulgular), legatify_get_report_pdf, legatify_check_content, legatify_fix_content, legatify_get_precedent.

claude.ai, Claude Desktop ve mobil — hesabınızla giriş (OAuth)

Bu yolda API anahtarı gerekmez; Claude sizi Legalitify giriş ve izin ekranına yönlendirir.

1. Free, Pro, Max: Claude’da Customize → Connectors → Add custom connector. (Free planda bir özel bağlayıcı eklenebilir.)
   Team, Enterprise: kuruluş sahibi Organization settings → Connectors → Add → Custom (tür sorulursa Web) ile ekler; üyeler sonra Customize → Connectors’ta “Custom” etiketli bağlayıcıda Connect’e basar.
2. Sunucu adresi olarak https://legalitify.com/mcp girin. OAuth istemci kimliği/sırrı alanlarını boş bırakın; iletişim kutusu kimlik doğrulama ayarı soruyorsa Sign in now ve OAuth istemcisi için Register automatically seçin (Legalitify dinamik istemci kaydını destekler). Add’e basın.
3. Connect’e basın; açılan Legalitify sayfasında giriş yapın, istenen yetkileri ve yönlendirme adresini (claude.ai) kontrol edip İzin ver’e basın.
4. Sohbette + → Connectors menüsünden bağlayıcıyı açıp kapatabilirsiniz. Erişimi kaldırmak için panelde API Anahtarları → Bağlı uygulamalar.

Claude Code — API anahtarıyla

claude mcp add --transport http legalitify https://legalitify.com/mcp \
  --header "Authorization: Bearer ANAHTARINIZ"

Ekibinizle paylaşacağınız .mcp.json dosyasında anahtarı ortam değişkeninden okuyun (Claude Code ${VAR} genişletmesini destekler):

{
  "mcpServers": {
    "legalitify": {
      "type": "http",
      "url": "https://legalitify.com/mcp",
      "headers": { "Authorization": "Bearer ${LEGALITIFY_API_KEY}" }
    }
  }
}

Claude Desktop — yapılandırma dosyasıyla (isteğe bağlı)

Önerilen yol yukarıdaki Connectors ekranıdır. Anahtarla bağlanmak isterseniz claude_desktop_config.json (Windows: %APPDATA%\Claude\, macOS: ~/Library/Application Support/Claude/) dosyasına topluluk tarafından geliştirilen mcp-remote köprüsünü ekleyebilirsiniz (Node.js gerekir; Anthropic ürünü değildir):

{
  "mcpServers": {
    "legalitify": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://legalitify.com/mcp",
               "--header", "Authorization:${LEGALITIFY_AUTH}"],
      "env": { "LEGALITIFY_AUTH": "Bearer ANAHTARINIZ" }
    }
  }
}

Başlık değerindeki boşluk Windows’ta sorun çıkardığı için Bearer … değeri env içinde tutulur. Dosyayı kaydedip Claude Desktop’ı yeniden başlatın.

4. ChatGPT’ye bağlama (Custom GPT Actions)

1. ChatGPT’de GPT oluşturun (veya mevcut GPT’nizi düzenleyin) → Configure → Actions → Create new action.
2. Import from URL: https://legalitify.com/api/kyl/v1/openapi.json
3. Authentication → API Key → Auth Type: Bearer → anahtarınızı (legk_live_…) girin ve kaydedin.
4. GPT talimatlarına şunu eklemenizi öneririz: “Web taramasında önce startWebScan çağır; getScanStatus ile is_terminal true olana dek bekle; sonra getScanReport. Sonuçların hukuki görüş olmadığını belirt.”

Arayüz adları OpenAI tarafından değiştirilebilir. ChatGPT’nin MCP bağlayıcı desteği bu rehberde ele alınmamıştır; desteklenen yol OpenAPI Actions’tır.

5. Yetkiler (kapsamlar)

• Taramalarımı ve raporlarımı okuma (scan:read)
• Benim adıma web taraması başlatma (scan:write)
• Reklam/içerik metni kontrolü ve düzeltme (content:check)

Yetkisi olmayan bir işlem 403 insufficient_scope döner. Claude bağlayıcısında yetkiler izin ekranında gösterilir.

6. Paket sınırları

Sınırlar kullanıcı başınadır (anahtarlarınız ve bağlı uygulamalarınız ortak sayılır). Günlük işlem kotasına MCP’de yalnız araç çağrıları (tools/call) sayılır. Yanıt başlıkları: X-RateLimit-Limit, X-RateLimit-Remaining; aşımda Retry-After. Web taraması ve içerik kontrolü panel ile aynı kredi/tarama hakkından düşer; başarısız işlemde kredi düşmez. Ayrıntı: Fiyatlandırma.

7. Hata kodları

MCP’de araç hataları (yetki, kredi, girdi) araç sonucunda isError: true ile döner; kimlik hataları HTTP 401/403’tür.

8. Güvenlik ve webhook

• Anahtarı yalnız sunucu tarafında veya güvendiğiniz yapay zekâ istemcisinde kullanın; tarayıcıya, mobil uygulamaya veya herkese açık depolara koymayın. Sızdıysa panelden hemen iptal edin.
• Tarama hedefi ve webhook adresi herkese açık bir adres olmalıdır; iç ağ, localhost ve özel IP aralıkları reddedilir.
• webhook_url verirseniz tarama bitince sonuç POST edilir; gövde, panelde gösterilen hesabınıza özel sırla HMAC-SHA256 imzalanır ve X-Legalitify-Signature başlığında gelir. Gövdenin ham hâliyle hesaplayıp sabit zamanlı karşılaştırın.
• PDF/web rapor bağlantıları süreli ve imzalıdır; bağlantıya sahip herkes raporu görebilir, yalnız güvendiğiniz kişilerle paylaşın.

Soru ve geri bildirim: bilgi@legalitify.com