API Dokümantasyonu - PratikEsnaf

Hızlı Başlangıç

API'ye erişmek için önce bir token almanız gerekir. API key ve secret bilgilerinizi PratikEsnaf panelinden alabilirsiniz.

Token Alma

curl -X POST https://api.pratikesnaf.com/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "pk_live_xxxxxxxxxxxxx",
    "api_secret": "sk_live_xxxxxxxxxxxxx"
  }'

Yanıt 200 OK

{
  "success": true,
  "data": {
    "token": "eyJ0eXAiOiJKV1QiLCJ...",
    "expires_at": "2026-02-23T14:30:00Z",
    "token_type": "Bearer"
  }
}

Aldığınız token'ı sonraki isteklerde Authorization header'ında kullanın:

Authenticated Request

curl https://api.pratikesnaf.com/api/v1/stok \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJ..." \
  -H "Accept: application/json"

Base URL

https://api.pratikesnaf.com/api/v1/

Tüm API endpoint'leri bu base URL üzerinden erişilebilir. Yanıtlar JSON formatındadır.

Kimlik Doğrulama

API, Bearer Token tabanlı kimlik doğrulama kullanır. Her istekte Authorization header'ı göndermeniz gerekir.

Önemli: API anahtarlarınızı asla client-side kodda (JavaScript, mobil uygulama) açık olarak kullanmayın. Sunucu tarafından istekte bulunun.

Rate Limiting

API istekleri rate limit ile korunmaktadır. Aşağıdaki limitler geçerlidir:

Plan	Limit	Süre
Başlangıç	100 istek	Dakika başına
Profesyonel	500 istek	Dakika başına
Kurumsal	2000 istek	Dakika başına

Rate limit bilgileri her yanıtta header olarak döner:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 498
X-RateLimit-Reset: 1708617060

Hata Kodları

API hata durumlarında standart HTTP durum kodları döner:

Kod	Durum	Açıklama
200	OK	İstek başarılı.
201	Created	Kaynak başarıyla oluşturuldu.
400	Bad Request	İstek parametreleri hatalı.
401	Unauthorized	Geçersiz veya eksik token.
403	Forbidden	Bu kaynağa erişim yetkiniz yok.
404	Not Found	Kaynak bulunamadı.
429	Too Many Requests	Rate limit aşıldı. Biraz bekleyin.
500	Server Error	Sunucu hatası. Tekrar deneyin.

Hata yanıtı formatı:

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Zorunlu alan eksik: sk_stokAdi",
    "details": {
      "sk_stokAdi": ["Bu alan zorunludur."]
    }
  }
}