🔐Yetkilendirme

PerculusApi üzerinden servislere gönderilecek tüm isteklerde "HEADER" alanına Authentication key olarak Bearer token eklenmelidir.

Bearer token olarak kullanacağımız ACCESS_TOKEN'i oluşturmak için gerekli parametreleri aşağıda görebilirsiniz:

• DOMAIN: QuickStart alanında belirtilen "Unvan"

• 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

ACCOUNT_ID verisi için sistem yöneticiniz ile iletişime geçip hesabınıza ait olan "ACCOUNT_ID" verisine sahip olabilirsiniz

Tüm parametrelerimiz hazır ise, aşağıdaki alanda bulunan örneği uygulayarak ACCESS_TOKEN verisine erişebilirsiniz.

CURL

Aşağıdaki CURL isteğini attıktan sonra response olarak ACCESS_TOKEN gelecektir.

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>'

Aşağıda örnek response modelini görebilirsiniz:

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

Python

İlk olarak Python SDK'sı yüklenmelidir:

pip install perculus-sdk

SDK'nın yüklendiğinden emin olunduktan sonra ilgili kod bloğuna SDK import edilmelidir:

from perculus_sdk.client import APIClient

Son olarak; parametreleriniz ile "set_credentials" metodunu kullanarak authentication işlemini tamamlayabilirsiniz.

# API client
client = APIClient()

# Set your domain
client.set_domain("<DOMAIN>")

# Set your credentials
client.set_credentials(
    access_key="<EMAIL>",
    secret_key="<PASSWORD>",
    account_id="<ACCOUNT_ID>"
)

Bu akış sonrasında SDK'da bulunan her bir servis için tekrar tekrar yetkilendirme işlemi yapmadan diğer metodları istediğiniz gibi kullanabilirsiniz.

C#

// ASAP :)

NodeJS

// ASAP :)

Go

// ASAP :)

ACCESS_TOKEN daha sonra kullanılacak tüm servislerde gerekecektir. Bu nedenle ACCESS_TOKEN'inizi güvenli bir yerde saklamayı unutmayın.