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

# Hızlı Başlangıç

İlk isteğinizi atabilmek için aşağıdaki adımları takip etmeniz gerekmektedir:

* [Hesap oluşturma](#hesap-olusturma)
* [API Kullanıcısı oluşturma](#api-kullanicisi-olusturma)
* [Yetkilendirme](#yetkilendirme)
* [İlk istek ](#ilk-istek):rocket:

### Hesap Oluşturma

İlk olarak [Perculus](https://perculus.com) platformumuzdan bir hesap açmanız gerekmektedir. Hesabınız var ise  bu adımı atlayabilirsiniz. 

{% hint style="warning" %}
Hesap ayarlarınızda bulunan "Unvan" alanını dokuman içerisinde domain olarak isimlendireceğiz, bu alanı istek atarken kullacağımız için bu alanı not etmeniz önemlidir.
{% endhint %}

<figure><img src="https://3119204134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FutFCKCNGAraDGh5gVAfX%2Fuploads%2FyWHDPvVrim6Zcumclk86%2FScreenshot%202024-08-15%20at%2016.49.02.png?alt=media&amp;token=5ecf2d1d-14b1-48e6-8e5d-6772be4e4ee4" alt=""><figcaption></figcaption></figure>

### API Kullanıcısı Oluşturma

Daha önce oluşturmuş olduğunuz hesabınıza giriş yapıp PerculusAPI'yi kullanabilmek için bir API kullanıcısı oluşturmanız gerekmektedir.&#x20;

Bu işlem için aşağıdaki adımları takip edebilirsiniz;

1. **Perculus platformuna** [**buradan**](https://perculus.com/tr/login) **giriş yapınız.**<br>

   <figure><img src="https://3119204134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FutFCKCNGAraDGh5gVAfX%2Fuploads%2Fp7uV67eWiWzzPKejpSfK%2FScreenshot%202024-08-15%20at%2016.33.05.png?alt=media&amp;token=a9dd2c55-0661-44e4-8d66-d669a9ec32fc" alt=""><figcaption></figcaption></figure>

2. **Giriş yaptıktan sonra "Kullanıcılar" bölümünden "Yeni Kullanıcı" butonuna tıklayarak yeni kullanıcı ekleme alanını açınız.**<br>

   <figure><img src="https://3119204134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FutFCKCNGAraDGh5gVAfX%2Fuploads%2FBLDPfIgdCkfqfkUjqACD%2FScreenshot%202024-08-16%20at%2012.18.46.png?alt=media&amp;token=a61d99b5-8c60-458b-9e2e-9e1bc77db7c5" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Bu aşamada kullanıcı oluşturma formunda email ve şifre alanlarına yazacağınız bilgileri API'ye istek atarken kullanacağız. Bu nedenle bu kullanıcının ***silinmemesi*** gerektiğini unutmayın.
{% endhint %}

### Yetkilendirme

API'ye isteğimizi atmadan önce, daha önce oluşturduğumuz API kullanıcımız için bir ACCESS\_TOKEN almamız gerekmektedir.&#x20;

ACCESS\_TOKEN alabilmek için atacağımız istekte ACCOUNT\_ID verisine ihtiyacımız olacaktır.

{% hint style="warning" %}
ACCOUNT\_ID verisi için sistem yöneticiniz ile iletişime geçip hesabınıza ait olan "ACCOUNT\_ID" verisine sahip olabilirsiniz
{% endhint %}

Son olarak ACCESS\_TOKEN almak için ihtiyacınız olan parametreler ile beraber örnek bir CURL yapısını aşağıda görebilirsiniz:

* DOMAIN: Yukarda belirtilen "Unvan" alanındaki veri
* EMAIL: API için oluşturduğumuz kullanıcının email adresi
* PASSWORD:  API için oluşturduğumuz kullanıcının şifresi
* ACCOUNT\_ID

```bash
curl --location 'https://<DOMAIN>/connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'username=<EMAIL>' \
--data-urlencode 'password=<PASSWORD>' \
--data-urlencode 'client_id=api' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'account_id=<ACCOUNT_ID>'
```

Parametrelerinizi doğru bir şekilde attığınızda aşağıdaki gibi bir response gelecektir.&#x20;

```json
{
    "access_token": "<ACCESS_TOKEN>",
    "expires_in": 36000,
    "token_type": "Bearer",
    "scope": "api"
}
```

{% hint style="danger" %}
**ACCESS\_TOKEN daha sonra kullanılacak tüm servislerde gerekecektir. Bu nedenle ACCESS\_TOKEN'inizi güvenli bir yerde saklamayı unutmayın.**
{% endhint %}

### İlk İstek  :rocket:

GroupsAPI'ye ilk isteğinizi atabilmeniz için gerekli tüm adımları yukarıda belirttik ve artık ilk isteğinizi atmak için hazırsınız.

İstek atarken CURL yöntemini kullanacağız. Bu işlemi sistemdeki tüm oturumlarınızı listeleyebileceğiniz `/session` endpointi ile örnekleyeceğiz.

İstek atabilmek için ihtiyaçlarımız:

* Domain
* Access Token

Şimdi örnek servisimiz olan oturum listesi için CURL yapısını görebilirsiniz:

```bash
curl --location 'https://<DOMAIN>/xapi/session' \
--header 'Authorization: Bearer <ACCESS_TOKEN>'
```

Yukardaki örnek isteği attığınızda response olarak tüm oturumlarınızı listeleyebileceksiniz.

Bu sayede ilk isteğimizi atmayı başardık  :rocket:&#x20;