> 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ıç

* [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="/files/QYLt6BDy2vnCfr3jtWXq" 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="/files/uimn1B98FuqullfOt8B1" 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="/files/Rd0D8PAMuqHXhkEf3aDW" 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;