Ana içeriğe geç

Yetkilendirme

API Giriş Bilgilerinin Alınması​

API giriş bilgilerini almak için aşağıdaki adımları takip edebilirsiniz:

  • egaranti panel adresine giriş yapın.
  • Sol menüden Ayarlar sekmesine tıklayın.
  • Hesap Ayarları butonuna tıklayın.
  • Hesap Ayarları sayfasında Firma Bilgileri sekmesine tıklayın.
  • Firma Bilgileri sayfasında API Anahtarı ve SECRET Anahtarı bilgilerini görebilirsiniz.
  • API Anahtarı ve SECRET Anahtarı bilgilerini kopyalayarak kullanabilirsiniz.

Test ve Canlı Ortam Base URL'leri​

Base Url
https://replica-integration.egaranti.dev
Postman Collection Link

Kolaylık sağlaması açısından Postman Collection linkini aşağıda paylaşıyoruz.

Postman Collection

API Bağlantısının Kurulması​

Entegrasyon servislerine istekler Bearer Token ile atılmalıdır. Bunun için öncelikle Bearer Token oluşturulmalıdır. Bearer Token oluşturmak için aşağıdaki endpointe yukarıdaki adımdan aldığınız API Anahtarı ve SECRET Anahtarı bilgilerini göndermelisiniz.

Request​

curl --location --request POST '<BASE_URL>/auth'
     --header 'Content-Type: application/json'
     --data '{
        "apiKey": "<string>",
        "secretKey": "<string>"
     }'

Response​

{
  "jwtToken": "Bearer <string>",
  "expiredAt": "2023-08-28 12:04"
}
Dikkat

Bu servisten dönen jwtToken değerinin geçerlilik süresi 30 dakika olarak ayarlanmıştır. Süre dolduğunda yeni bir jwtToken değeri almanız gerekmektedir, expiredAt değeri ile jwtToken'in geçerlilik süresini kontrol edebilirsiniz.

Bu servisten aldığınız jwtToken değerini diğer endpointlerde Authorization header'ına ekleyerek isteklerinizi gerçekleştirebilirsiniz. Örnek bir istek aşağıdaki gibidir.

curl --location --request GET '<BASE_URL>/main-categories'
     --header 'Content-Type: application/json'
     --header 'Authorization: <jwtToken>'