Token Alma

Panel üzerinden uygulama oluşturduktan sonra aşağıdaki işlemlere geçilir.

Panel üzerinden İstemci ID ve Gizli Anahtar bilgilerini kullanarak aşağıdaki endpointe istek atılır. Bu istek token gerektirmez.

Token Alma İsteği

POST: /api/v1/auth/application

{api_url}/api/v1/auth/application

İçerik

Alan	Tip	Zorunlu	Açıklama
clientId	string	Evet	İstemci ID
secret	string	Evet	Gizli Anahtar

{
  "clientId": "eaeE34e3",
  "secret": "secret"
}

Sample cURL

$ curl -X POST {api_url}/api/v1/auth/application \
    -H 'Content-Type: application/json' \
    -d '{
    "clientId": "eaeE34e3",
    "secret": "secret"
}'

Cevap (200)

{
  "success": true,
  "message": "Uygulama jetonu oluşturuldu",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

Token yanıtta data.token alanında döner; eski sürümdeki gibi kök seviyede değildir.

Hatalar

HTTP	code	Açıklama
401	CLIENT_ID_OR_SECRET_INVALID	İstemci ID ya da Gizli Anahtar hatalı, ya da uygulama pasif
422	VALIDATION_FAILED	clientId ya da secret gönderilmedi
500	INTERNAL_ERROR	Beklenmeyen bir hata oluştu; tekrar deneyin

{
  "success": false,
  "code": "CLIENT_ID_OR_SECRET_INVALID",
  "message": "İstemci kimliği ya da sırrı hatalı."
}

Token Kullanımı

Dönen token'ı her istekte Authorization başlığında Bearer önekiyle gönderin. Token süresi 1 saattir.

$ curl {api_url}/api/v1/finance/invoices \
    -H 'Authorization: Bearer {token}'

Bu işlemlerden sonra token ile ZEMLOG API v1'i kullanarak işlemlerinizi kolayca gerçekleştirebilirsiniz.