Geliştirici API'si ve MCP
Shopify Flow için Workflow Transactional Email REST API ve MCP sunucusu: e-posta şablonlarını okuyun, HTTP isteklerini koddan veya yapay zekadan yönetin.
E-posta şablonlarınızı**, e-posta gönderenlerinizi, gizli bilgilerinizi, yüklenen dosyalarınızı ve HTTP isteklerinizi** kendi kodunuzdan veya bir yapay zeka asistanından okuyabilir ve HTTP isteklerinizi ile medya dosyalarınızı yönetebilirsiniz. Workflow Transactional Email, bir REST API’si ve bir MCP sunucusu sunar; her ikisi de uygulama içindeki Geliştirici sayfası üzerinden yönetilir.
Her şey tek bir kimlik bilgisi kullanır ve her iki platform da aynı kuralları uygular: gizli bilgileriniz hiçbir zaman okunamaz ve geçmiş verileri geri döndürülmeden önce maskelenir.
Kısa versiyon
Ana URL
https://shopify.workflow-transactional-email.appGeliştirici sayfasında oluşturulan bir taşıyıcı anahtarla kimlik doğrulaması yapın. Anahtarlar fak_ ile başlar ve oluşturuldukları anda bir kez görüntülenir.
Üç erişim düzeyi, sıralı ve birikimli:
| Seviye | Ekler |
|---|---|
| Oku | E-posta düzenlerini, gönderenleri, gizli adları, yüklenen dosyaları, HTTP isteklerini, geçmişi ve istatistikleri okuyun |
| Okuma ve yazma | HTTP istekleri oluşturun, düzenleyin ve silin; kullanılmayan yüklü dosyaları silin |
| Oku, yaz ve çalıştır | HTTP isteğini gerçek hedefe yöneltin |
Varsayılan olarak okuma anahtarları verilir.
Medya dosyalarınızı düzenleme
Yaygın bir kullanım örneği: Artık hiçbir öğe tarafından referans gösterilmeyen tüm yüklü logoları veya resimleri bulup silmek.
# every file, each flagged with whether a layout or preset still uses it
curl "https://shopify.workflow-transactional-email.app/api/v1/files?usage=true" \
-H "Authorization: Bearer fak_your_key_here"
# delete one that nothing references
curl -X DELETE "https://shopify.workflow-transactional-email.app/api/v1/files" \
-H "Authorization: Bearer fak_your_key_here" \
-H "Content-Type: application/json" \
-d '{"key":"uploads/your-shop.myshopify.com/abc123.png"}'Bir mizanpaj veya üstbilgi/altbilgi ön ayarı tarafından hâlâ kullanılan bir dosya, onu kullanan öğenin adı belirtilen bir 409 hatasıyla reddedilir; böylece bir temizleme komut dosyası, yanlışlıkla aktif bir e-postayı bozamaz.
İlk talep
Bir tuşun çalıştığını doğrulayın ve ne işe yaradığını görün:
curl https://shopify.workflow-transactional-email.app/api/v1/me \
-H "Authorization: Bearer fak_your_key_here"İlgili makaleler
- Sırlar - Uygulamanın içinde gizli veriler nasıl çalışır?
- Shopify Flow'dan bir HTTP isteği gönderin - bu uç noktaların yapılandırdığı HTTP eylemi.
- Ekler ve resimler - Uygulamada dosya yükleme ve yeniden kullanma.
- Geçmiş ve sorun giderme - Yürütme geçmişinde neler kaydedilir.
