01Kimlik Doğrulama

Soncarfilo API'si iki aşamalı bir kimlik doğrulama süreci kullanır. Önce API anahtarınızı (API Key) kullanarak geçici bir JWT token alırsınız, ardından bu token'ı sonraki isteklerinizde Authorization: Bearer başlığıyla kullanırsınız.

Adım 1

Token Alımı

API anahtarınızı kullanarak sistemden erişim anahtarı alın.

POST /auth/token/

curl -X POST https://api.soncarfilo.com/auth/token/ \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "YOUR_API_KEY"}'

Başarılı Yanıt Örneği:

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresAt": "2026-01-21T11:10:25Z"
}

Adım 2

Bearer Token Kullanımı

Aldığınız token'ı tüm API isteklerinizde Header olarak ekleyin.

Authorization Header

Authorization: Bearer YOUR_TOKEN_HERE

02Uç Noktalar (Endpoints)

Sistem Durumu (Health)

Servisin çalışıp çalışmadığını kontrol eder. Kimlik doğrulama gerektirmez.

GET/v1/health/

curl -i https://api.soncarfilo.com/v1/health/

Bağlantı Testi (Ping)

Token'ınızın geçerliliğini ve yetkilerinizi kontrol eder. Bearer token gerektirir.

GET/v1/ping/

curl -i https://api.soncarfilo.com/v1/ping/ \ -H "Authorization: Bearer YOUR_TOKEN"

Güvenlik ve IP Kısıtlamaları

API anahtarlarınızı oluştururken IP kısıtlaması ekleyebilirsiniz. IP kısıtlaması aktifse, sadece tanımlı IP adreslerinden gelen istekler kabul edilecektir. Eğer IP kısıtlaması eklemezzseniz, anahtarınız tüm IP adreslerinden kullanılabilir olacaktır (Önerilmez).

Tüm iletişim SSL/TLS üzerinden şifrelenmektedir.