TRTürkçeENEnglish
Mağazanızı açın

Milofly için uygulama geliştirin.

Uygulamanız mağazalara belgelenmiş bir API, tek tek onaylanan izinler ve imzalı olay bildirimleriyle bağlanır. Mağazacı kurmadan önce uygulamanızın hangi veriye eriştiğini görür; uygulamanız onun panelinin içinde açılır.

Geliştirici portalına gidin Belgeleri okuyun

Geliştirici hesabınızı e-postanızla ya da Google hesabınızla kendiniz açarsınız; belgeler giriş yapmadan okunur.

Uygulama kurulumuMağazacının gördüğü
Uygulamanızşu izinleri istiyor
  • Siparişleri görme
  • Müşterinin adı ve e-postası
  • Kendi ürünlerinin stoğunu yazma
  • Sipariş olaylarını bildirimle alma
Yeni bir izin istendiğinde onay yeniden alınır.
Kurulumdaki izin ekranı. Sadeleştirilmiş görünüm, örnek verilerle.

Ücretsiz katılın; uygulama geliştirip mağazalarda satın.

Geliştirici hesabı, belgeler, test mağazası ve yayın için Milofly'a ücret ödemezsiniz. Mağazacılar uygulamaları her pakette kurar; ücretli uygulamalar sizin belirlediğiniz fiyatla satılır.

  1. Ücretsiz katılın

    Geliştirici hesabı, belgeler ve test mağazası için ücret ödemezsiniz. Vitrin bileşenlerinin ayarları, içerik kaynakları ve açılır pencere tipleri de portalda belgelidir.

  2. Uygulama geliştirin

    Ücretsiz geliştirici hesabı, belgelenmiş uygulama API'si, imzalı olay bildirimleri ve ücretsiz test mağazası. Uygulamanız incelemeden sonra her mağazacının uygulama mağazasında listelenir.

  3. Mağazalarda satın

    Mağazacı uygulamanızı hangi paketi kullanırsa kullansın kurar. Uygulamanıza fiyat planı tanımlarsınız; tahsilatları ve payınızı portaldaki kazanç ekranında görürsünüz.

Bir uygulamanın ihtiyaç duyduğu her şey hazır.

Kendi uygulamalarımızı da aynı araçlarla yazıyoruz. Size ayrı ya da eksik bir yol sunmuyoruz.

  • Belgelenmiş uygulama API'si

    Ürün, kategori, fiyat, stok, depo, sipariş, sevkiyat, müşteri, kupon, fatura ve gönderi verisine belgelenmiş uçlardan erişirsiniz. Her yanıt uyarıları açıkça söyler; toplu işlemde kısmi başarı gizlenmez.

  • Tek tek onaylanan izinler

    Sipariş okumak ile müşterinin adını ve adresini görmek, stok yazmak ile fatura sonucu yazmak ayrı izinlerdir. Uygulamanız yalnız istediği ve mağazacının onayladığı veriye erişir.

  • OAuth ile kurulum

    Mağazacı kurulumda uygulamanın istediği izinleri görür ve onaylar. Yeni bir izin istediğinizde onay yeniden alınır; uygulama kaldırılınca erişimi kapanır.

  • İmzalı olay bildirimleri

    Sipariş, ödeme, kargo, iptal ve iade olayları size HMAC-SHA256 ile imzalanmış bildirimlerle gelir. Ulaşmayan bildirim yeniden denenir; teslimatları portaldan izlersiniz.

  • Panelin içinde açılan uygulama

    Uygulamanız ayrı bir sekmede değil, mağazacının panelinin içinde açılır. Mağazacının kimliği sunucunun imzaladığı kısa ömürlü bir jetonla gelir; süresi dolunca panel yeniler.

  • Sipariş, müşteri ve ürün sayfalarında bölüm

    Sipariş, müşteri ve ürün ayrıntı sayfalarına kendi bölümünüzü eklersiniz. Mağazacı işini bırakmadan uygulamanızı kullanır.

  • Ücretsiz test mağazası

    Gerçek bir test mağazası açar, kurulumu ve izin ekranını mağazacının göreceği haliyle baştan sona denersiniz. Test mağazası için abonelik ücreti alınmaz.

  • Sağlayıcı olarak bağlanma

    Kargo firması, e-Fatura sağlayıcısı ya da ölçüm aracı olarak çekirdeğe dokunmadan bağlanırsınız. Sağlayıcı kaydı Milofly ile birlikte açılır, mağazacı ayrıca onaylar.

  • Uygulama mağazasında yayın

    Herkese açık uygulamanız incelemeden sonra her mağazacının panelindeki uygulama mağazasında listelenir. Hangi ülkelerde kurulabileceğini seçer, yorumlara yanıt verir, kurulumlarınızı bölge bölge izlersiniz.

  • Kendi mağazanız için özel uygulama

    Yalnız kendi mağazalarınızda kullanacağınız uygulama katalogda görünmez ve incelemeye girmeden kurulur.

  • Bileşen ve içerik sözleşmesi

    Vitrin bileşenlerinin ayarları, içerik kaynakları ve açılır pencere tipleri portalda belgelidir.

  • Beş dilde geliştirici portalı

    API belgeleri, olay listesi ve yetenek kataloğu geliştirici portalındadır. Portal Türkçe, İngilizce, Almanca, Fransızca ve Arapça kullanılır.

Kayıttan yayına dört adım.

  1. 1

    Uygulamanızı kaydedin

    Geliştirici portalında uygulamanızı kimlik, teknik ayarlar, vitrin sayfası ve özet adımlarıyla kaydedin. İstemci kimliği ve gizli anahtarlar yalnız bir kez gösterilir; istediğinizde yenilenir.

  2. 2

    Test mağazasında deneyin

    Ücretsiz test mağazası açın; kurulumu, izin ekranını ve bildirimleri gerçek bir mağazada görün. Portaldan imzalı test olayı gönderip teslimatı izleyin.

  3. 3

    Mağazacı onaylasın

    Mağazacı izinleri görüp onaylar. Uygulamanız tek kullanımlık kodu erişim jetonuna çevirir ve API'yi çağırmaya başlar.

  4. 4

    Yayınlayın

    Yalnız kendi mağazalarınız içinse hemen kurun. Herkese açık uygulamayı incelemeye gönderin; onaylanınca uygulama mağazasında listelenir.

Tanıdık bir REST API ve imzalı bildirimler.

Uygulamanız erişim jetonunu Authorization başlığında gönderir. Yanıt, jetonun izinlerine göre şekillenir: izin verilmeyen kişisel veri gövdeye hiç girmez.

  • Her bildirim konu, mağaza, zaman ve gövdeden üretilen HMAC-SHA256 imzasıyla gelir
  • Uygulamanız aynı imzayı kendi gizli anahtarıyla hesaplayıp karşılaştırır
  • Tanımadığınız bir olay adına abone olmaya çalışırsanız kayıtta hata alırsınız; sessizce çalışmayan abonelik olmaz
API isteğiorders.read
GET /api/apps/v1/orders?page=1&pageSize=20
Authorization: Bearer mfapp_…

200 OK
{
  "items": [{
    "id": 1048,
    "status": "<durum>",
    "grandTotal": 2349.90,
    "currency": "TRY",
    "customer": { "name": null, "email": null }
  }],
  "totalCount": 1, "page": 1, "pageSize": 20
}
Uygulamanın customers.read izni yoksa sipariş listesi müşterinin adını ve e-postasını boş döndürür. Örnek kısaltılmıştır.
Olay bildirimiPOST · application/json
POST <webhook adresiniz>
X-Milofly-Topic: order.paid
X-Milofly-Store: <mağaza kimliği>
X-Milofly-Timestamp: <Unix zamanı>
X-Milofly-Hmac-Sha256: <imza>
  • order.createdSipariş oluşturuldu
  • order.paidSipariş ödendi
  • order.shippedSipariş kargolandı
  • order.cancelledSipariş iptal edildi
  • order.refundedSipariş iade edildi
  • fulfillment.requestedSevkiyat talebi
  • shipment.create_requestedGönderi açma talebi
  • invoice.submit_requestedFatura gönderim talebi
  • app.uninstalledUygulama kaldırıldı
İmza konu, mağaza, zaman ve gövdeden HMAC-SHA256 ile üretilir. Uygulamanız aynı hesabı kendi gizli anahtarıyla yapıp bildirimi doğrular.

Kendi uygulamalarımız da aynı yoldan çalışır.

PaydaLink ve TyreSystem ayrı sunucularda, sizin kullanacağınız aynı API, izin ekranı ve bildirimlerle çalışır. Çekirdekte onlara özel bir kapı yoktur; yazdığınız uygulama onlarla aynı yeri alır.

  • PaydaLink

    PaydaLink

    Influencer'lar için takip kodu ve bağlantı. Sipariş olaylarını bildirimle alır, komisyonu siparişe maliyet satırı olarak yazar, iadede geri alır.

  • TyreSystem

    TyreSystem

    Almanya pazarındaki lastik toptancısının kataloğunu, stoğunu ve fiyatını mağazaya taşır; ürünleri uygulama API'siyle yazar, panelin içinde açılır.

Başlamadan önce bilmeniz gerekenler.

  • Zamanlanmış işlerZamana bağlı işleri kendi sunucunuzdaki zamanlayıcıyla çalıştırırsınız. Milofly uygulamanız adına görev zamanlamaz.
  • Ücretli uygulamalarUygulamanıza portaldan fiyat planı tanımlarsınız; tahsilatları kazanç ekranında görürsünüz. Ücretli uygulama yayınlamadan önce bizimle görüşün.
  • Mağazacı tarafıUygulama kurmak her pakette açıktır; mağazacı Başlangıç paketinde de uygulamanızı kurar. Geliştirici hesabı ve test mağazası ücretsizdir.

Uygulamanızı yazmaya başlayın.

Geliştirici hesabınızı açın, belgeleri okuyun, ücretsiz test mağazasında deneyin.

Geliştirici hesabı açın Belgeleri okuyun