Geliştiriciler

Mağazanın verisiyle kendi aracını yaz.

Siparişi depo yazılımına aktar, stoğu ERP’den güncelle, temayı baştan kur. API, webhook ve şablon dili aynı belgelerde anlatılıyor.

Kaydır

01 · Anahtar al

Panelden bir API anahtarı oluştur.

Ayarlar › Geliştirici ekranında anahtara ad verirsin, hangi verilere erişeceğini seçersin. Anahtar yalnız bir kez gösterilir, sonra yalnız ilk karakterleri görünür. İşi biten anahtarı iptal edersin.

02 · İlk istek

Siparişleri okuyarak başla.

Her istek Bearer anahtarıyla gelir, anahtar hangi mağazaya ait olduğunu da belirler. Listeler imleçle sayfalanır, tutarlar kuruş cinsinden ve para birimiyle döner.

Örnek taslaktır, adres ve alanlar değişebilir.

03 · Olayları dinle

Yeni sipariş gelince haber al.

Webhook adresini panele eklersin, hangi olayları istediğini seçersin. Her gönderim gizli anahtarınla imzalanır. Yanıt vermezsen gönderim aralıklarla tekrar denenir.

Neler var

Elinin altındakiler.

Henüz olmayanları ayrıca işaretledik.

  • REST API

    Ürün, stok, sipariş, kargo, iade, müşteri, kampanya, içerik ve fiyat listesi okuma.

  • Webhook’lar

    Olay kataloğu, imzalı gönderim, teslimat geçmişi ve tekrar gönderme.

  • OpenAPI ve SDK

    Şema koddan üretilir. TypeScript SDK aynı şemadan gelir.

  • Tema şablon dili

    Liquid benzeri dil, bölüm şemaları ve doğrulayıcıyla tema yaz.

  • Herkese açık portalHenüz yok

    Belgeler şimdilik yalnız panele giriş yapan firmalara açık.

  • Eklenti çerçevesiHenüz yok

    Panele kendi ekranını ekleyen uygulamalar.

Ayrıntılar

API ile çalışırken.

Belgelere erişim

Türkçe ve İngilizce belgeler, panelden Geliştirici ekranındaki bağlantıyla açılır. Herkese açık portal henüz yok.

Sürümleme

Kaldırılacak bir uç önce değişiklik günlüğünde duyurulur. Yanıtlarda kaldırılma tarihini bildiren başlıklar gelir.

Yazma uçları

Okuma uçlarının çoğu hazır. Ürün oluşturma, güncelleme ve stok yazma uçlarının tamamı henüz yok.

  • Müşteri ve adres yazma süreli yazma anahtarıyla açık
  • Bağlantıdan görsel içe aktarma henüz yok

Sorular

Sık sorulanlar

API kullanımında sınır var mı?

Anahtar sayısı ve günlük istek sınırı paketine bağlıdır. Sınır aşılırsa yanıt, ne zaman tekrar deneyebileceğini söyler.

Belgeleri görmek için hesap gerekiyor mu?

Şimdilik evet. Belgeler panele giriş yapan firmalara açık. Herkese açık geliştirici portalı henüz yok.

Hangi dilde SDK var?

TypeScript SDK var. Diğer dillerde OpenAPI şemasından kendi istemcini üretebilirsin.

Uygulamamı başka mağazalara satabilir miyim?

Henüz değil. Eklenti çerçevesi ve dış geliştirici programı yok. Haberdar olmak istersen bize yaz.

İlgili sayfalar

Bir test mağazası aç, ilk isteği at.

Mağazanı aç, Geliştirici ekranından anahtarını al. 3 gün ücretsiz, sonrasında ilk 3 ay toplam 150 TL (KDV dahil, tek ödeme).