# auth.md: gmod.tr

gmod.tr, Türk Garry's Mod sunucularının listesi ve oy sitesidir. Bu dosya yapay zeka ajanlarına
gmod.tr'de nasıl kimlik doğrulanacağını anlatır.

## Anahtarsız erişim (okuma)

Herkese açık sayfaları anahtar olmadan okuyabilirsin; her sayfanın Markdown hâli vardır:

- Sunucu listesi: https://gmod.tr/index.md
- Tek sunucu: https://gmod.tr/sunucu/<slug>.md
- Mod sayfaları: https://gmod.tr/mod/<mod>.md
- Site özeti: https://gmod.tr/llms.txt

Bu sayfalar kişisel veri içermez ve 15 dakikada bir güncellenir. Yapılandırılmış veri (JSON)
gerekiyorsa aşağıdaki API'yi kullan.

## API (anahtarla)

- Temel adres: https://gmod.tr/api/v1
- Dokümantasyon: https://gmod.tr/devs.md
- OpenAPI: https://gmod.tr/api/v1/openapi.json
- Kimlik doğrulama: `Authorization: Bearer <anahtar>`

## Anahtar alma

gmod.tr'de otomatik kayıt, OAuth istemcisi ya da ajan adına hesap açma yoktur. Giriş sadece
Steam ile yapılır ve bir insan tarafından yapılmalıdır.

1. Kullanıcı gmod.tr'de Steam ile giriş yapar.
2. Profilinde (https://gmod.tr/sunucularim → "API anahtarlarım") Kullanım Koşulları'nın "Geliştirici
   API'si" maddesini kabul edip kişisel anahtar (`gmtd_`) oluşturur. Sunucu sahibiyse aynı
   bölümden sunucusunun anahtarına (`gmtr_`) geçebilir.
3. Anahtarı ajana kendisi verir (ör. ortam değişkeni `GMODTR_KEY`).

Ajan olarak:

- Kullanıcı adına Steam girişi yapmaya, CAPTCHA ya da bot korumasını aşmaya çalışma.
- Önce ortamda mevcut bir anahtar olup olmadığına bak; yoksa kullanıcıdan iste.
- Anahtarı sohbete, loglara, istemci tarafı koda ya da herkese açık depolara yazma.
- Hız sınırı anahtar başına dakikada 120 istek; `429` gelirse `Retry-After` kadar bekle.

## Hukuki

- Kullanım Koşulları: https://gmod.tr/yasal/kosullar
- KVKK Aydınlatma Metni: https://gmod.tr/yasal/kvkk
- Gizlilik: https://gmod.tr/yasal/gizlilik

## İletişim

sametcamur10@hotmail.com