Genel Bakış
Hızlı Başlangıç
Birkaç dakikada posentegra API'sine bağlanın.
Giriş
posentegra API'si, Yemeksepeti, Migros Yemek ve Uber Eats / Trendyol GO gibi platformlardan gelen siparişleri tek bir uçtan POS sisteminize taşır. İşletme, restoran, platform entegrasyonu, webhook mimarisi ve kurye yazılımları ile tam uyumlu çalışır.
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.
bash
curl https://api.v1.fastsiparis.com/web-api/v1/restaurants \
-H "Authorization: Bearer POSENTEGRA_API_KEY"Örnek yanıt:
restaurants.response.json
json
{
"success": true,
"data": [
{
"id": "rst_2f9a1c",
"ad": "Merkez Şube",
"durum": "aktif"
}
]
}Sipariş akışı
- 1Sipariş platformdan düşer — Yemeksepeti, Migros Yemek veya Uber Eats / Trendyol GO 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.