# Auth.md — ŞefKapında ajan erişim rehberi

Son güncelleme: 2026-09-19
Kaynak: https://sefkapinda.com/

## Özet

ŞefKapında'nın herkese açık içeriği (şef profilleri, konseptler, blog, tarif ve şehir
sayfaları) kimlik doğrulaması gerektirmez ve ajanlar tarafından okunabilir.
Kullanıcıya özel alanlar (müşteri paneli, şef paneli, acente paneli, yönetim paneli)
yalnızca giriş yapmış kullanıcılar tarafından erişilebilir.

## Kimlik doğrulama gerektirmeyen yüzeyler

- `GET https://sefkapinda.com/` ve tüm herkese açık sayfalar
- `GET https://sefkapinda.com/llms.txt`
- `GET https://sefkapinda.com/sitemap.xml`
- `GET https://sefkapinda.com/.well-known/*` keşif dosyaları
- Özel şef talebi: `https://sefkapinda.com/ozel-talep` (giriş gerekmez)

## Kimlik doğrulama gerektiren yüzeyler

| Alan | Adres | Gereklilik |
| --- | --- | --- |
| Müşteri paneli | `/panel/musteri` | Kullanıcı girişi |
| Şef paneli | `/panel/sef` | Şef hesabı |
| Acente paneli | `/panel/acente` | Acente hesabı |
| Yönetim paneli | `/admin` | Yönetici hesabı |
| Rezervasyon oluşturma | `/panel/musteri` üzerinden | Kullanıcı girişi |

## Ajan kaydı

Şu anda ajanlar için otomatik (dynamic client registration) OAuth istemci kaydı
açık değildir. Ortak entegrasyonlar için:

1. https://sefkapinda.com/iletisim üzerinden veya WhatsApp `+90 552 419 8812`
   numarasından entegrasyon talebi gönderin.
2. Talebinizde ajan adı, kullanım amacı, gereken kapsamlar (`scopes`) ve iletişim
   adresini belirtin.
3. Onaylanan entegrasyonlara istemci bilgileri ve kapsamlar e-posta ile iletilir.

Kapsam adları: `profile`, `bookings:read`, `bookings:write`, `subscription:read`.

## Kurallar

- Oturum çerezleri veya kullanıcı tokenları üçüncü taraflarla paylaşılamaz.
- Kullanıcı adına rezervasyon veya abonelik işlemi yapılmadan önce açık onay alınmalıdır.
- İçerik sinyalleri: `ai-train=no`, `search=yes`, `ai-input=yes`
  (bkz. https://sefkapinda.com/robots.txt).
- Atıf: içerik alıntılandığında ŞefKapında (https://sefkapinda.com) belirtilmelidir.

## İlgili metadata

- ARD manifesti: `/.well-known/ai-catalog.json`
- API kataloğu: `/.well-known/api-catalog`
- MCP server card: `/.well-known/mcp/server-card.json`
- A2A agent card: `/.well-known/agent-card.json`
- Agent skills: `/.well-known/agent-skills/index.json`
- OAuth protected resource: `/.well-known/oauth-protected-resource`