# Kartal Nakliye auth.md - Agent Registration & Authentication

Temsilciler (AI Agents), otonom botlar ve API entegrasyonları için Kartal Nakliye kimlik doğrulama ve kayıt protokolü.

## 1. Genel Bilgiler
- **Servis Adı:** Kartal Nakliye API & Agent Gateway
- **Ana Alan Adı:** https://kartalnakliye.tr
- **Protokol Standartları:** RFC 8414, RFC 9728, Auth.md, SEP-1649

## 2. Keşif Belgeleri (Discovery Documents)
- **OAuth Korumalı Kaynak:** [/.well-known/oauth-protected-resource](https://kartalnakliye.tr/.well-known/oauth-protected-resource)
- **OAuth Yetkilendirme Sunucusu:** [/.well-known/oauth-authorization-server](https://kartalnakliye.tr/.well-known/oauth-authorization-server)
- **OpenID Konfigürasyonu:** [/.well-known/openid-configuration](https://kartalnakliye.tr/.well-known/openid-configuration)
- **API Kataloğu:** [/.well-known/api-catalog](https://kartalnakliye.tr/.well-known/api-catalog)
- **MCP Sunucu Kartı:** [/.well-known/mcp/server-card.json](https://kartalnakliye.tr/.well-known/mcp/server-card.json)
- **Ajan Becerileri Endeksi:** [/.well-known/agent-skills/index.json](https://kartalnakliye.tr/.well-known/agent-skills/index.json)

## 3. Ajan Kayıt & Kimlik Tipleri (Agent Identity Types)
Kartal Nakliye aşağıdaki ajan kimlik doğrulama yöntemlerini destekler:

### 3.1 Anonim Ajan Erişimi (Anonymous Access)
- **Desteklenen Kimlik:** `anonymous`
- **Yetki Kapsamı:** Fiyat teklifi alma, rota mesafe hesaplama, araç uygunluğu sorgulama
- **Kullanım:** Temsilciler herhangi bir ön kayıt yapmadan `/.well-known/mcp/server-card.json` ve `/.well-known/agent-skills/index.json` üzerindeki araçları çağırabilir.

### 3.2 İstemci Kimlik Bilgileri (Client Credentials / Bearer Token)
- **Belirteç Uç Noktası:** `https://kartalnakliye.tr/oauth/token`
- **Kayıt Uç Noktası:** `https://kartalnakliye.tr/api/agent/register`
- **Talep Uç Noktası:** `https://kartalnakliye.tr/api/agent/claim`
- **Başlık Biçimi:** `Authorization: Bearer <TOKEN>`

## 4. İletişim & Manuel Yetkilendirme
API entegrasyonu veya toptan lojistik iş birlikleri için:
- **E-posta:** info@kartalnakliye.tr
- **Telefon:** +90 532 543 68 05
- **Web:** https://kartalnakliye.tr