API kimin için?

Restomarkt Geliştirici API'si ücretsizdir ve iki taraf için de kullanılabilir: tedarikçiler ürünlerini, stoklarını, siparişlerini ve hakedişlerini kendi ERP/depo yazılımlarından yönetir; restoranlar kendi sistemlerinden sipariş oluşturur ve takip eder. API kullanımı sipariş tutarına ek bir ücret getirmez.

API anahtarı nasıl oluşturulur?

Anahtarınızı doğrudan panelden oluşturursunuz: tedarikçiler için Tedarikçi Paneli > API, restoranlar için Restoran Paneli > API sayfası. Anahtarlar yalnızca oluşturulurken bir kez gösterilir; güvenli bir yerde saklayın. Anahtarı isteklerinizde Bearer başlığıyla gönderirsiniz; her anahtarın yetkileri scope'larla sınırlandırılır, böylece bir entegrasyona yalnızca ihtiyacı kadar erişim verirsiniz.

Neler yapılabilir?

Tedarikçi uçlarıyla ürün ekleme/güncelleme, kategori, sipariş yönetimi ve hakediş takibi; restoran uçlarıyla sipariş oluşturma, takip ve Restomenüm stok bildirimi yapılır. Webhook'lar sayesinde yeni sipariş gibi olaylar HMAC imzalı push bildirimlerle sisteminize anında iletilir; siparişleri sorgulamak için beklemenize gerek kalmaz.

API'yi MCP üzerinden Claude gibi yapay zekâ asistanlarına da bağlayabilirsiniz; ayrıntılar API dokümantasyonundaki MCP bölümündedir.

Standartlar ve dokümantasyon

API, restomarkt.com/api/v1 temel adresinde çalışır; tüm yanıtlar JSON'dur. Liste uçları standart sayfalama alır, sipariş oluşturma ucu çift siparişi önleyen Idempotency-Key başlığını destekler. Makine okunur OpenAPI şemasıyla sözleşmeyi Postman/Insomnia'ya aktarabilir veya kod üretebilirsiniz. Tüm uçlar, hata kodları ve örnekler API dokümantasyonu sayfasındadır.

Anahtar güvenliği

API anahtarınız hesabınız adına işlem yapar; şifreniz gibi koruyun. Anahtarı kod deposuna veya istemci tarafına koymayın, ortam değişkeninde tutun. Entegrasyon sırasında takıldığınız bir nokta olursa destek@restomarkt.com adresine yazabilirsiniz; en geç 1 iş günü içinde dönüş yapıyoruz.