Kimlik Doğrulama ve Token Alma

Kimlik doğrulama ve Token işlemlerinde JSON Web Token(JWT) Standardını kullanmaktadır. https://jwt.io

Token Nasıl Alınır

POST token

Bu metod ile kimlik doğrulama işlemi yapılır. Doğrulama işlemi başarılı ise Token döner. Bu Token kimlik doğrulama gerektiren tüm request işlemlerinde kullanılır.

access kimlik gerektiren tüm işlemlerde kullanılmalıdır.

refresh süresi biten access için yeniden token üretir.

Example request:

POST token HTTP/1.1
Host: app.postacell.com.tr/api/
Accept: application/json, application/x-www-form-urlencoded, multipart/form-data

Example response:

HTTP/1.1 200 Ok
Vary: Accept
Content-Type: application/json

{
  "access": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNTczNzQ3NDMwLCJqdGkiOiJmMDZkYTNiNjAwZjg0MDk0YmY3ODgxODllNmIyMjU0NiIsInVzZXJfaWQiOjF9.HwI_cfL3TsL-IXQS12txH3gft7ACUH8X_kA06uHTapU",
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTU3MzgzMzUzMCwianRpIjoiNjQ0YWVmYmUzZDVlNDQyNDhlNWNlY2RhZTQxMjUwMWMiLCJ1c2VyX2lkIjoxfQ.jrpHkLtXDjeAJT20hA5gNZDw2G2R__hwpgykzynVH3I"
}
Form Parameters

  • username or email – required

  • password – required

Status Codes

username ve password app.postacell.com.tr sitesine girişte kullandığınız ve sizin tarafınızdan oluşturulan bilgilerdir. username yerine email de kullanılabilir.

Bu giriş bilgilerine sahip değilseniz app.postacell.com.tr adresini ziyaret ediniz.

Not

reflesh token 24 saat, access token 5 dakika geçerlidir. 24 saat sonunda token api sine kullanıcı adı ve şifre girerek yeniden access ve reflesh token üretilmelidir.

Refresh Kullanarak Token Alma

POST token/refresh

Example request:

POST token/refresh HTTP/1.1
Host: app.postacell.com.tr/api/
Accept: application/json, application/x-www-form-urlencoded, multipart/form-data

Example response:

HTTP/1.1 200 Ok
Vary: Accept
Content-Type: application/json

{
  "access": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNTczNzQ3NDMwLCJqdGkiOiJmMDZkYTNiNjAwZjg0MDk0YmY3ODgxODllNmIyMjU0NiIsInVzZXJfaWQiOjF9.HwI_cfL3TsL-IXQS12txH3gft7ACUH8X_kA06uHTapU",
}
Form Parameters

  • refresh – required

Status Codes

Örnek Kullanım

Kimlik doğrulama gerektiren API uç noktaları erişmek için, access token değerini aşağıdaki gibi tüm request’lerin başlığına eklemelisiniz:

Örnek senaryomuzda GET metoduyla /api/v1/hello/ adresini çağırıyoruz.

Request

curl \
    -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNjAyNzQ3NTU2LCJqdGkiOiIxYWNjNTgwZDBiYjQ0NGNlYThiNDlmZDE5ZTRhNDU1MiIsInVzZXJfaWQiOjF9.KLEwNEuEIa5VWH9xW6d0rPNRGcYgoF-1l8j7txi0SeM" \
    https://app.postacell.com.tr/api/v1/hello/

Response

HTTP 200 OK
Content-Type: application/json
Vary: Accept

{
    "message": "Hello, World!"
}