API referansı (REST)
Üçüncü parti entegrasyonlar için REST API.
Authentication
Bearer token (JWT). Admin panel > API Keys'ten oluşturulur. Token 90 gün geçerli.
curl -H "Authorization: Bearer eyJhbGc..." https://api.somm.com.tr/v1/productsEndpoint'ler
En sık kullanılan endpoint'ler:
- GET /v1/products — Ürün listesi
- POST /v1/offers — Yeni teklif oluştur
- GET /v1/offers/:id — Teklif detayı
- POST /v1/customers — Yeni müşteri
- GET /v1/stores/:id/sales — Mağaza satışları
Rate limit
Normal hesap: 100 istek/dk. Premium: 500/dk. Aşımda 429 döner.
Webhook
Event-driven entegrasyon için webhook desteği. Teklif oluşturuldu, satış kapandı, iade açıldı eventleri.