> ## Documentation Index
> Fetch the complete documentation index at: https://developer.leaderos.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin API Nedir?

> LeaderOS Plugin API'ye genel bakış: oyun sunucusu eklentileri, Discord botları ve kendi entegrasyonlarınız için sunucudan sunucuya API.

## Plugin API nedir?

**Plugin API**, LeaderOS sitenizin **sunucudan sunucuya** çalışan API'sidir. LeaderOS'un resmi eklentileri (Minecraft, Hytale, FiveM, Rust, ARK, Unturned, Garry's Mod, CS2) ve Discord botu siteyle bu API üzerinden konuşur. Siz de kendi eklentinizi, botunuzu veya arka uç entegrasyonunuzu yazmak için kullanabilirsiniz.

> [card] Oyun içi giriş ve kayıt
>
> Oyuncuları site hesabıyla oyunda doğrulayın, kayıt edin, 2FA kodunu kontrol edin.

> [card] Mağaza ve kredi
>
> Oyun içi mağaza menüsü, kredi ile satın alma, kredi ekleme/çıkarma/gönderme.

> [card] Komut teslimi
>
> Satın alınan ürünlerin komutlarını LeaderOS Connect ile oyun sunucusunda çalıştırın.

> [card] Discord ve destek
>
> Discord rol eşitleme, destek talepleri, yapay zeka komutları.

## Plugin API ve Headless API farkı

| | Plugin API | Headless API |
| - | - | - |
| Adres | `https://siteniz.com/api` | `https://siteniz.com/headless/v1` |
| Kimler kullanır | Oyun eklentileri, botlar, sizin arka ucunuz | Web/mobil ön yüzler (temalar) |
| Anahtar | `X-Api-Key`, **gizli** | `X-LeaderOS-Key`, herkese açık |
| Yetki | Yönetici düzeyi (kredi değiştirme, rol verme…) | Oyuncu düzeyi (Bearer token ile) |
| Panel ayarı | **Ayarlar → API** | **Ayarlar → Headless API** |

> [!WARNING]
>
> Plugin API anahtarı **yönetici yetkisine** sahiptir: herhangi bir oyuncunun kredisini değiştirebilir, rol verebilir, satın alma yapabilir. Anahtarı **asla** tarayıcı kodunda, mobil uygulamada, herkese açık bir depoda veya oyunculara dağıtılan bir dosyada kullanmayın. Yalnızca sunucu tarafında saklayın.

## Temel bilgiler

* **Base URL:** `https://siteniz.com/api`
* **Kimlik doğrulama:** her istekte `X-Api-Key: <api anahtarı>` başlığı
* **İstek gövdesi:** `application/x-www-form-urlencoded` (veya `multipart/form-data`). **JSON gövde doğrulanmaz**, form biçiminde gönderin.
* **Diziler:** form dizisi olarak gönderilir, ör. `commands[]=15&commands[]=16`, `products[0][id]=12&products[0][quantity]=1`

## Yanıt biçimi

İşlem yapan uçlar şu zarfı döner:

```json theme={null}
{ "status": true, "data": { "token": "…" } }
```

```json theme={null}
{ "status": false, "error": "USER_NOT_FOUND", "message": "User not found!" }
```

Doğrulama hatasında `error` değeri `VALIDATION` olur ve `message` bir mesaj dizisidir:

```json theme={null}
{ "status": false, "error": "VALIDATION", "message": ["The Username is required"] }
```

> [!NOTE]
>
> Bazı okuma uçları (ör. `GET /store/products`, `GET /users`, `GET /credits`) zarf olmadan **doğrudan nesne veya dizi** döner. Her ucun yanıt biçimi API referansında belirtilmiştir.

**Her zaman `error` koduna göre dallanın**, `message`'a göre değil.

## HTTP durum kodları

| Kod | Anlamı |
| - | - |
| `200` | Başarılı |
| `400` | Hatalı istek, doğrulama hatası veya iş kuralı hatası (ör. `INSUFFICIENT_BALANCE`) |
| `401` | `INVALID_API_KEY` (anahtar yok/yanlış), `WRONG_PASSWORD`, `WRONG_CODE` |
| `403` | `REGISTER_LIMIT` |
| `404` | Kayıt bulunamadı (`USER_NOT_FOUND`…) **veya API kapalı** (gövdesiz 404) |
| `409` | `USERNAME_ALREADY_EXIST`, `EMAIL_ALREADY_EXIST` |

## Uç noktalar

| Grup | Ne yapar |
| - | - |
| Auth | Giriş, kayıt, oturum kontrolü/oluşturma, oyuna giriş durumu, 2FA |
| Store | Mağaza ağacı, ürünler, kategoriler, kredi ile satın alma, bağışçılar, topluluk hedefi |
| Credits | Bakiye okuma, ekleme, çıkarma, ayarlama, oyuncular arası gönderme |
| Users | Kullanıcı bilgisi, siparişler, destek talepleri, roller (ver/değiştir/sil) |
| Bazaar | Oyuncu pazarı deposu (eşya ekleme/çıkarma), pazar sunucuları |
| Support | Destek talepleri, mesajlar, kategoriler, hazır cevaplar |
| Vote | Oy verme bağlantıları |
| Discord | Discord ID ile kullanıcı, Discord ayarları, Discord rolleri |
| Integrations | LeaderOS ID oyun içi doğrulama, LeaderOS AI komutları |
| Command logs | LeaderOS Connect komut kuyruğu ve doğrulama |

Tüm parametreler ve yanıtlar için soldaki **API referansı** grubuna bakın.

## Nereden başlamalı?

**1. API'yi açın**

Panelden API'yi etkinleştirip anahtarınızı alın → [Kurulum](https://developer.leaderos.net/plugin-api/tr/setup.md)

**2. Kendi entegrasyonunuzu yazın**

Örnek isteklerle başlayın → [Kullanım örnekleri](https://developer.leaderos.net/plugin-api/tr/usage.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.