Admin API ve web kancaları, uygulamada
Shopify'a karşı entegrasyonlar çoğunlukla iki mekanizmadır: okuyup yazmak için çağırdığınız Admin API ve bir şey olduğunda sizi çağıran web kancaları.
İkisi de basit. Güvenilir bir entegrasyonu istikrarsızından ayıran şey, yanlış davrandıkları durumları nasıl ele aldığınızdır — ve davranacaklardır.
İki mekanizma#
| Admin API | Web kancaları | |
|---|---|---|
| Yön | Siz Shopify'ı çağırırsınız | Shopify sizi çağırır |
| İyi olduğu iş | Durum okuma, değişiklik yazma, toplu doldurma | Olaylara çabuk tepki |
| Hata biçimi | Hız sınırı, sürüm değişimi | Tekrar, sırasız teslim, kaçan olay |
| Ele alınmalı | Yeniden deneme ve sayfalama | Yinelemeye dayanıklılık ve doğrulama |
Entegrasyonu güvenilir kılan kurallar#
- Yükü güvenmeden önce her web kancasının imzasını doğrulayın. Doğrulanmayan uç nokta açık kapıdır.
- Her işleyiciyi yinelemeye dayanıklı yapın — aynı olay eninde sonunda iki kez gelir.
- Sırayı varsaymayın. Bir iptal, beklediğiniz oluşturmadan önce gelebilir.
- Hızlı yanıt verip işi asenkron yapın; yavaş uçlar yeniden denenir, sonra kapatılır.
- Günlük olarak API'ye karşı mutabakat yapın. Web kancaları olay kaçırır; gecelik tarama kaçanı yakalar.
Hız sınırı bir tasarım girdisidir#
Shopify API erişimini ölçer. Bu, yeniden denemeyle aşılacak bir engel değil, tasarlanacak bir kısıttır. Okumaları toplu yapın, yalnız ihtiyacınız olan alanları isteyin ve toplu doldurmada her ürünü tek tek dolaşmak yerine toplu işlemleri kullanın.
Entegrasyonunuz yalnız başka hiçbir şey çalışmıyorken çalışıyorsa çalışmıyordur. Bir içe aktarım sürerken test edin.
Sürümleme#
API sürümleri tarihlidir ve süresi dolar. Yükseltmeyi bir hatayla keşfetmek yerine takvime koyun. Küçük bir entegrasyonu ileri taşımak bir saat sürer; dört sürüm atlamış olan bir hafta sürer.
Sıkça sorulan sorular
Web kancası mı yoklama mı?
Çabukluk için web kancası, doğruluk için dönemsel mutabakat. Güvenilir entegrasyonların çoğu ikisini birden kullanır.
Yinelenen işlemeyi nasıl engellerim?
Olay kimliğini saklayıp tekrarları yok sayın. Buradaki en değerli tek alışkanlık budur.
Ölçekte ilk ne bozulur?
Hız sınırları; genelde kayıtları toplu işlem yerine tek tek dolaşan bir doldurma sırasında.
shopify admin apishopify webhookshopify entegrasyonshopify api hız sınırıshopify graphql api
