Genel Bakış
Hızlı Başlangıç
Birkaç dakikada posentegra API'sine bağlanın.
Giriş
posentegra API'si, Yemeksepeti, Getir ve Trendyol Yemek gibi platformlardan gelen siparişleri tek bir uçtan POS sisteminize taşır. İşletme, restoran, platform entegrasyonu ve paket yönetimini tek entegrasyonla kod yazarak veya paneli kullanarak sürdürebilirsiniz.
Taban adres https://api.v1.fastsiparis.com'dur; bu referanstaki her uç nokta /web-api/v1 ile başlayan tam yoluyla yazılmıştır (ör. https://api.v1.fastsiparis.com/web-api/v1/restaurants). Tüm başarılı yanıtlar { success, data } zarfıyla döner. Nereden başlayacağınızı seçin:
- Kimlik Doğrulama — API anahtarınızı nasıl göndereceğinizi öğrenin.
- İlk Entegrasyon — sıfırdan başlayıp sipariş alır hale gelin.
- API Referansı — tüm uç noktaların tam listesi.
Yaklaşımlar
| Yaklaşım | En uygun |
|---|---|
| REST API | Tam kontrol, her dil, bağımlılık yok. |
| Webhook | Sipariş düştüğü anda sizin ucunuza bildirim. |
| Panel | Kod yazmadan restoran ve entegrasyon yönetimi. |
Kurulum
API isteklerinizi kimliklendirmek için önce bir API anahtarı oluşturmanız gerekir.
- Yönetim Anahtarları ekranını açın.
- Yeni bir anahtar oluşturun ve güvenli bir yere kaydedin.
- İsteklerinizde
Authorizationbaşlığında kullanın.
Anahtar bir kez gösterilir
Oluşturduğunuz anahtarı kaybederseniz panelden yenisini oluşturmanız gerekir.
İlk istek
Anahtarınızla işletmelerinizin listesini çekmeyi deneyin.
curl https://api.v1.fastsiparis.com/web-api/v1/restaurants \
-H "Authorization: Bearer POSENTEGRA_API_KEY"Örnek yanıt:
{
"success": true,
"data": [
{
"id": "rst_2f9a1c",
"ad": "Merkez Şube",
"durum": "aktif"
}
]
}Sipariş akışı
- 1Sipariş platformdan düşer — Yemeksepeti/Getir/Trendyol Yemek tarafında oluşan sipariş posentegra tarafına iletilir.
- 2verify — Sipariş doğrulanır ve POS tarafında işleme alınır. endpoint →
- 3change-status — Durum güncellenir: hazırlanıyor → yolda → teslim. endpoint →
- 4Raporla — Tamamlanan sipariş panelde ve raporlarda görünür.