​
Uygulama Aksiyonları

Uygulama aksiyonları, app’inizin Hemen Mağaza admin panelindeki belirli ekranlarda kullanıcıya komut olarak görünmesini sağlar. Örneğin sipariş detayından ERP’ye aktarım başlatmak veya ürün detayından dış sistem senkronizasyonu çalıştırmak mümkündür.

​
Action tipleri

TipKullanım
iframeKullanıcıya embedded arayüz açılır. App Bridge session ile çalışır.
apiHemen Mağaza, app endpoint’ine imzalı server-side POST gönderir.

​
İlk hedef konumlar

product.detail.header
order.detail.header
order.list.bulk
Bu konumlar, ürün ve sipariş akışlarında en sık ihtiyaç duyulan entegrasyon noktalarıdır.

​
Action güvenliği

Action çalıştırılırken şu kontroller yapılmalıdır:
  • App aktif mi?
  • App ilgili tenant için kurulu veya yetkili mi?
  • Action için gereken scope app tarafından alınmış mı?
  • iframe action için origin allowlist uygun mu?
  • API action için imza ve timestamp doğrulanıyor mu?
Gerekli scope yoksa action 403 ile reddedilir.

​
API action akışı

  1. Kullanıcı admin panelinde action’a tıklar.
  2. Hemen Builders action kaydını ve tenant bağlamını bulur.
  3. Required scope kontrolü yapılır.
  4. App endpoint’ine imzalı POST gönderilir.
  5. Response kullanıcıya başarı veya hata olarak gösterilir.
  6. Audit log yazılır.
Örnek payload: 
{
  "action_id": "act_123",
  "tenant_id": "velunamora",
  "location": "order.detail.header",
  "resource": {
    "type": "order",
    "id": 9001
  }
}

​
iframe action akışı

  1. Kullanıcı action’a tıklar.
  2. Signed iframe URL üretilir.
  3. iframe allowed origin kontrolünden geçer.
  4. App Bridge session başlar.
  5. App, admin.context.request ile ekran bağlamını isteyebilir.
Örnek App Bridge event: 
bridge.dispatch("admin.context.request", {
  resource: "order",
});

​
Ne zaman action kullanılmalı?

Action kullanmak için iyi örnekler:
  • Siparişi ERP’ye aktar.
  • Sipariş için kargo etiketi üret.
  • Ürünü pazaryerine gönder.
  • Ürün görselini dış serviste işle.
Action kullanmamak gereken durumlar:
  • Arka planda otomatik çalışması gereken işler.
  • Kullanıcı onayı gerektirmeyen webhook senaryoları.
  • Storefront tarafında çalışan pixel/script işleri.
Bu işler için webhook veya storefront script registry daha doğru olabilir.