> For the complete documentation index, see [llms.txt](https://egitim.leaderos.com.tr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://egitim.leaderos.com.tr/api-kullanimi.md).

# API Kullanımı

API'ye yaptığınız istek sonucu size bir JSON verisi döndürür. Bu veriyi plugin veya skript ile işleyip oyuncularınıza gösterebilirsiniz.

{% hint style="info" %}
Giriş ve Kayıt ol sistemi için Yönetim Paneli > Sistem Ayarları "Auth API" aktif olmalıdır.
{% endhint %}

## Giriş Yap

<mark style="color:green;">`POST`</mark> `https://siteniz.com/apps/api/login.php`

Kullanıcı adı ve şifreyi doğrulayabilirsiniz.

#### Path Parameters

| Name     | Type   | Description                                                    |
| -------- | ------ | -------------------------------------------------------------- |
| token    | String | /apps/main/private/config/app.php içerisindeki APP\_KEY değeri |
| ip       | String | Kullanıcının IP Adresini                                       |
| username | String | Kullanıcı Adı                                                  |
| password | String | Hashlenmemiş şifre                                             |

{% tabs %}
{% tab title="200: OK Başarılı dönüş" %}

```json
{
    'status' => true,
}
```

{% endtab %}

{% tab title="200: OK Şifre Hatalı" %}

```json
{
    'status' => false,
    'message' => "Şifre hatalı!"
}
```

{% endtab %}

{% tab title="200: OK Kullanıcı Bulunamadı" %}

```json
{
    'status' => false,
    'message' => "Kullanıcı bulunamadı!"
}
```

{% endtab %}
{% endtabs %}

## Kayıt Ol

<mark style="color:green;">`POST`</mark> `https://siteniz.com/apps/api/register.php`

Kullanıcıyı kayıt edebilirsiniz.

#### Path Parameters

| Name     | Type   | Description                                                    |
| -------- | ------ | -------------------------------------------------------------- |
| token    | String | /apps/main/private/config/app.php içerisindeki APP\_KEY değeri |
| ip       | String | Kullanıcının IP Adresini                                       |
| username | String | Kullanıcı Adı                                                  |
| email    | String | Eposta Adresi                                                  |
| password | String | Hashlenmemiş şifre                                             |

{% tabs %}
{% tab title="200: OK Başarılı Dönüş" %}

```javascript
{
    'status' => true,
    'accountID' => int, // Tam sayı bir kullanıcı ID'si döner.
}
```

{% endtab %}

{% tab title="200: OK Hatalı İşlem" %}

```javascript
{
    'status' => false,
    'message' => "Hata mesajı burda yazar!"
}
```

{% endtab %}
{% endtabs %}

## Kredi Geçmişi

<mark style="color:blue;">`GET`</mark> `https://siteniz.com/apps/api/credit-history.php`

**Örnek Kullanım:**\
Kullanıcı adı **LeaderOS** olan **2 adet** veriyi getirir.\
<https://premium.leaderos.com.tr/apps/api/credit-history.php?**username**=LeaderOS&**limit**=2\\>
**NOT:** username ve limit parametreleri zorunlu değildir.

#### Path Parameters

| Name     | Type    | Description                                         |
| -------- | ------- | --------------------------------------------------- |
| username | string  | Kullanıcı adına göre filtreleme yapabilirsiniz.     |
| limit    | integer | Kaç adet veri gösterileceğini filtreleyebilirsiniz. |

{% tabs %}
{% tab title="200 Örnek bir JSON formatında geridönüş:" %}

```javascript
[
    {
        accountID: 1,
        username: "demo",
        amount: 12,
        creationDate: "2020-12-21 22:40:11"
    },
    {
        accountID: 2,
        username: "LeaderOS",
        amount: 20,
        creationDate: "2020-12-21 22:39:50"
    }
]
```

{% endtab %}
{% endtabs %}

## Mağaza Geçmişi

<mark style="color:blue;">`GET`</mark> `https://siteniz.com/apps/api/store-history.php`

**Örnek Kullanım:**\
Kullanıcı adı **LeaderOS** olan **2 adet** veriyi gösterir.\
<https://premium.leaderos.com.tr/apps/api/store-history.php?**username**=LeaderOS&**limit**=2\\>
**NOT:** username ve limit parametreleri zorunlu değildir.

#### Path Parameters

| Name     | Type    | Description                                         |
| -------- | ------- | --------------------------------------------------- |
| username | string  | Kullanıcı adına göre filtreleme yapabilirsiniz.     |
| limit    | integer | Kaç adet veri gösterileceğini filtreleyebilirsiniz. |

{% tabs %}
{% tab title="200 Örnek bir JSON formatında geridönüş:" %}

```javascript
[
    {
        accountID: 2,
        username: "LeaderOS",
        serverName: "Factions",
        productName: "250K Para",
        price: 5,
        creationDate: "2020-07-21 22:38:35"
    },
    {
        accountID: 1,
        username: "demo",
        serverName: "Factions",
        productName: "100K Para",
        price: 3,
        creationDate: "2020-07-21 22:38:25"
    }
]
```

{% endtab %}
{% endtabs %}

## En Çok Kredi Yükleyenler

<mark style="color:blue;">`GET`</mark> `https://siteniz.com/apps/api/top-credit-history.php`

**Örnek Kullanım:**\
Kullanıcı adı **LeaderOS** olan **2 adet** veriyi gösterir.\
<https://premium.leaderos.com.tr/apps/api/top-credit-history.php?**username**=LeaderOS&**limit**=2\\>
**NOT:** username ve limit parametreleri zorunlu değildir.

#### Path Parameters

| Name     | Type    | Description                                         |
| -------- | ------- | --------------------------------------------------- |
| username | string  | Kullanıcı adına göre filtreleme yapabilirsiniz.     |
| limit    | integer | Kaç adet veri gösterileceğini filtreleyebilirsiniz. |

{% tabs %}
{% tab title="200 Örnek bir JSON formatında geridönüş:" %}

```javascript
[
    {
        accountID: 1,
        username: "demo",
        amount: 30,
        count: 1, // tek seferde 30 kredi yüklemiş
        creationDate: "2020-12-21 22:40:11"
    },
    {
        accountID: 2,
        username: "LeaderOS",
        amount: 20,
        count: 2, // 2 seferde 20 kredi yüklemiş
        creationDate: "2020-12-21 22:39:50"
    }
]
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://egitim.leaderos.com.tr/api-kullanimi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.