> ## 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.

# Kurulum

> Plugin API'yi yönetim panelinden etkinleştirin, API anahtarınızı alın ve ilk isteğinizi gönderin.

## 1. API'yi etkinleştirin

**1. Yönetim paneline girin**

`https://siteniz.com/dashboard` adresinden giriş yapın. Bu sayfa için **MANAGE\_SETTINGS** yetkisi gerekir.

**2. Ayarlar → API sayfasını açın**

**API Durumu** anahtarını açın. Değişiklik anında kaydedilir.

**3. API anahtarını kopyalayın**

**API Anahtarı** alanındaki değeri kopyalayın. Bu anahtarı eklenti yapılandırmasında ve kendi entegrasyonlarınızda kullanacaksınız.

> [!NOTE]
>
> API kapalıyken veya anahtar boşken tüm `/api` istekleri **gövdesiz 404** döner. Eklentiniz "bağlanamıyor" hatası veriyorsa önce bu ayarı kontrol edin.

## Panel ayarları

| Ayar | Açıklama |
| - | - |
| **API Durumu** | Ana şalter. Kapalıyken eklentiler, Discord botu ve tüm entegrasyonlar siteye erişemez. |
| **API Anahtarı** | `X-Api-Key` başlığında gönderilen gizli anahtar. Panelde salt okunur gösterilir. |
| **Sıfırla** | Yeni anahtar üretir. Sizi leaderos.net'e yönlendirir, onaydan sonra yeni anahtar kaydedilir. |
| **Yardım** | Bu sayfanın yardım makalesini açar. |

> [!WARNING]
>
> Anahtarı sıfırladığınızda **eski anahtarı kullanan her şey çalışmayı durdurur**: oyun sunucusu eklentileri, Discord botu ve kendi entegrasyonlarınız. Sıfırladıktan sonra tüm `config` dosyalarını yeni anahtarla güncelleyin ve sunucuları yeniden başlatın. Anahtarın sızdığından şüpheleniyorsanız hemen sıfırlayın.

> [!NOTE]
>
> API anahtarı, LeaderOS'un harici servisleriyle (LeaderOS Connect, LeaderOS ID, LeaderOS AI) de kullanılır. Bu yüzden anahtar yerelde değil, leaderos.net üzerinden üretilir.

## 2. İlk isteğiniz

```bash theme={null}
curl -H "X-Api-Key: API_ANAHTARINIZ" \
     "https://siteniz.com/api/credits?username=Steve"
```

```json theme={null}
{ "credits": "150,00", "raw_credits": 150, "currency": "TRY" }
```

Form gövdeli bir istek:

```bash theme={null}
curl -X POST https://siteniz.com/api/credits/add \
  -H "X-Api-Key: API_ANAHTARINIZ" \
  -d "target_username=Steve" \
  -d "amount=25"
```

```json theme={null}
{ "status": true, "data": { "credits": "175,00", "raw_credits": 175, "currency": "TRY" } }
```

> [!TIP]
>
> `curl -d` gövdeyi otomatik olarak `application/x-www-form-urlencoded` gönderir. JSON gönderirseniz (`-H "Content-Type: application/json"`) doğrulama başarısız olur ve `VALIDATION` hatası alırsınız.

## 3. Güvenlik önerileri

* Anahtarı yalnızca sunucu tarafında saklayın (ortam değişkeni, sunucudaki `config` dosyası).
* Anahtarı Git deposuna eklemeyin; `config` dosyalarını paylaşırken anahtarı silin.
* Anahtar oyun içinde kimseye gösterilmemeli; eklenti mesajlarında veya loglarda yazdırmayın.
* Sunucu sağlayıcınız destekliyorsa API isteklerini yalnızca oyun sunucunuzun IP'sinden kabul edecek bir güvenlik duvarı kuralı ekleyebilirsiniz (ör. Cloudflare).
* Personel değişikliğinde veya şüphe halinde anahtarı sıfırlayın.

## Sık karşılaşılan hatalar

| Belirti | Sebep | Çözüm |
| - | - | - |
| Gövdesiz `404` | API kapalı veya anahtar boş | **Ayarlar → API**'den açın |
| `401 INVALID_API_KEY` | Başlık yok veya anahtar yanlış | `X-Api-Key` başlığını ve değeri kontrol edin |
| `400 VALIDATION` | Zorunlu alan eksik veya JSON gönderildi | Form biçiminde gönderin, alanları kontrol edin |
| `404 USER_NOT_FOUND` | Kullanıcı adı/ID bulunamadı | Minecraft sitelerinde kullanıcı adı **büyük/küçük harf** dahil eşleşmelidir |

## Sonraki adım

> [card] [Kullanım örnekleri](https://developer.leaderos.net/plugin-api/tr/usage.md)
>
> Kendi eklentinizden, botunuzdan veya arka ucunuzdan API'yi çağırın.


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