Kimlik doğrulama
Anahtarınızı panelden oluşturun (Tedarikçi → /tedarikci/api, Restoran → /restoran/api) ve her isteğe Bearer olarak ekleyin. Anahtar yalnızca oluşturulurken bir kez gösterilir.
curl https://restomarkt.com/api/v1/orders \
-H "Authorization: Bearer rmk_live_xxxxxxxxxxxx"Anahtarınızı test edin
GET /api/v1/me anahtarın sahibini ve yetkilerini döner — entegrasyon kurulumunda ilk çağrı olarak kullanın.
GET /api/v1/me
curl https://restomarkt.com/api/v1/me \
-H "Authorization: Bearer rmk_live_xxxxxxxxxxxx"
// Yanıt:
{
"owner_type": "supplier",
"owner_id": "uuid",
"owner_name": "Örnek Gıda Ltd.",
"scopes": ["products:read", "products:write", "orders:read", "orders:write", "settlements:read", "webhooks:manage"]
}Yetkiler (scope)
Anahtar oluştururken hangi yetkilere sahip olacağını seçersiniz; uçlar yalnızca gerekli scope'u taşıyan anahtarları kabul eder.
| Scope | Açıklama |
|---|---|
| products:read | Ürün kataloğunu okuma (tedarikçi) |
| products:write | Stok/fiyat/aktiflik güncelleme (tedarikçi) |
| orders:read | Siparişleri listeleme/görme |
| orders:write | Sipariş oluşturma (restoran) / durum güncelleme (tedarikçi) |
| stock:read | Stok kalemlerini ve eşleme durumunu okuma (restoran — POS entegrasyonu) |
| stock:write | Malzeme stok bildirimi — mutlak veya delta (restoran — POS/Restomenüm entegrasyonu) |
| settlements:read | Aylık hakediş kayıtlarını okuma (tedarikçi — muhasebe entegrasyonu) |
| settings:read | Kargo, teslimat planı ve hizmet bölgesi ayarlarını okuma (tedarikçi) |
| settings:write | Kargo, teslimat planı ve hizmet bölgesi ayarlarını güncelleme (tedarikçi) |
| webhooks:manage | Webhook kaydı oluşturma/listeleme/silme |
Hız sınırı (rate limit)
Her API anahtarı dakikada en fazla 120 istek yapabilir. Sınır aşıldığında 429 durum kodu ve Retry-After: 60 başlığı döner — bu durumda bekleyip yeniden deneyin. Toplu işler için tekil çağrılar yerine toplu uçları tercih edin: stok bildirimi tek istekte 500 kaleme kadar kabul eder.
429 yanıtı
{ "error": "Hız sınırı aşıldı: anahtar başına dakikada en fazla 120 istek." }