Söyle Gelir Geliştiriciler

Sürüm notları

API v1 içinde yanıtlara yeni alanlar, yeni uçlar ve yeni olaylar eklenebilir; mevcut alanların adı ve türü değişmez. Yazılımınız tanımadığı alanları ve olayları yok saymalıdır.

14 Kasım 2026

Entegrasyon firmaları

  • POS ve kurye firmaları işletmenin panelden verdiği iki anahtarla (X-Api-Key + X-Api-Secret) bağlanır; firmanın Söyle Gelir'de hesap açması gerekmez.
  • Yeni: Kurye API (/api/v1/courier). İşletmenin onayladığı teslimat siparişleri bağlı kurye firmasına kendiliğinden gider; firma kurye bilgisini, konumu ve teslimi bildirir.
  • POS firmaları İşletme ve POS API'sini iki anahtarla kullanır; işletmenin bütün siparişleri POS'a order.placed ve order.status.changed olarak bildirilir.
  • Yeni webhook olayları: order.assigned, order.released (kurye firmaları).
  • Sipariş nesnesine delivery_partner alanı eklendi: siparişin gönderildiği kurye firması ve firmanın bildirdiği kurye.

İşletme API'si

  • Yeni: GET /products (sayfalı; barkod, stok ve seçenek gruplarıyla), GET /products/{id}, GET /couriers (atanabilir kuryeler).

İlk sürüm

  • İşletme API'si: siparişleri listeleme ve okuma, onaylama, durum geçişleri ve kurye atama, ürün fiyatı / stoğu, mağaza durumu.
  • İşletmenin kendi adresine webhook: order.placed, order.status.changed.