Genel bakış
Restomarkt Geliştirici API'si ücretsizdir. Tedarikçiler ürün/stok ve siparişlerini, restoranlar sipariş oluşturma ve takibini kendi sistemlerinden yönetir. Anahtarınızı panelden oluşturun: Tedarikçi → /tedarikci/api, Restoran → /restoran/api.
Temel URL
https://restomarkt.com/api/v1Hızlı başlangıç
curl https://restomarkt.com/api/v1/orders \
-H "Authorization: Bearer rmk_live_xxxxxxxxxxxx"Bölümler
Kimlik Doğrulama ve Yetkiler
API anahtarı, Bearer kullanımı ve scope'lar.
Tedarikçi Uçları
Ürün CRUD, kategoriler, sipariş yönetimi ve hakediş.
Restoran Uçları
Sipariş oluşturma, takip ve Restomenüm stok bildirimi.
Webhook'lar
Sipariş olaylarını HMAC imzalı push bildirimlerle alın.
MCP ile Kullanım
API'yi Claude gibi yapay zekâ asistanlarına bağlayın.
Hata Kodları
Durum kodları ve hata yanıt formatı.
Standartlar
Sayfalama
Tüm liste uçları ?limit (varsayılan 50, en çok 200) ve ?offset alır; yanıt meta: { limit, offset, total } bloğu içerir.
Idempotency
POST /orders Idempotency-Key başlığını destekler: ağ hatasında aynı anahtarla güvenle tekrar deneyebilirsiniz; çift sipariş oluşmaz.
OpenAPI şeması
Makine okunur sözleşme (kod üretimi, Postman/Insomnia içe aktarma): /api/v1/openapi.json
- API ücretsizdir; platform sipariş tutarına ek ücret koymaz.
- Anahtarlar yalnızca oluşturulurken bir kez gösterilir; güvenle saklayın.
- Tüm yanıtlar JSON'dur; hata formatı için Hata Kodları sayfasına bakın.