Kaldırma (Uninstall Hook)
Mağaza yöneticisi uygulamanızı App Store üzerinden kaldırdığında App Store, Uninstall Hook URL'nize bir bildirim gönderir. Bu bildirimle mağazaya ait kayıtlarınızı silmeniz beklenir.
- 1.Mağaza yöneticisi→App Store
Uygulamayı kaldırır
- 2.App Store→Uninstall Hook URL'niz
Kaldırma bildirimini gönderir
POST, JSON gövdesindeusername,hashvedomain. - 3.Uninstall Hook URL'niz
hash'i doğrular ve mağaza verisini siler
- 4.Uninstall Hook URL'niz→App Store
HTTP 200 döner
200 dışındaki yanıtlarda bildirim sınırlı sayıda yeniden denenir.
İstek
Code
| Alan | Açıklama |
|---|---|
username | Mağaza adresinin MD5 özeti: md5("https://magaza-adiniz.myideasoft.com"). |
hash | {"username":"<username>"} metninin Client Secret ile alınmış HMAC-SHA256 imzası (onaltılık). |
domain | Uygulamayı kaldıran mağazanın şemayla birlikte adresi. |
Doğrulama
hashdeğerini gövdedekiusernameile yeniden hesaplayın ve sabit zamanlı karşılaştırın. İmzalanan metin PHPjson_encodeçıktısıdır:{"username":"ab0119d06bd5dc4be1748543e1441ceb"}.usernamedeğerininmd5(domain)ile aynı olduğunu kontrol edin.- Doğrulama başarılıysa mağazaya ait token'ları ve kayıtları silin, ardından HTTP 200 dönün.
Test vektörü: client_secret=ornek-client-secret ve domain=https://magaza-adiniz.myideasoft.com için username değeri ab0119d06bd5dc4be1748543e1441ceb, hash değeri d5193458e451ae287da4f0b4fe012a67de9a75c62fcb22e50712a62690f9d8d8 olur. Yukarıdaki istek örneği bu değerlerle kurulmuştur; endpoint'inizi curl ile deneyebilirsiniz:
Code
Yanıt ve yeniden deneme
- Yalnızca HTTP 200 başarılı sayılır.
201,204dahil diğer yanıtlar ve bağlantı hataları başarısız kabul edilir. - Başarısız bildirim bir kuyruk üzerinden sınırlı sayıda yeniden denenir; denemeler arasındaki süre garanti edilmez.
- Aynı mağaza için bildirim birden fazla kez gelebilir. İşleyicinizi buna göre (idempotent) tasarlayın: kayıtlar zaten silinmişse de 200 dönün.
- Bildirimi hızla yanıtlayın; uzun süren silme işlemlerini arka planda yürütün.
Eski format
Önceki sürümlerde username ve hash Uninstall Hook URL'nin yolunda veya sorgu dizesinde gönderiliyordu. Güncel formatta tüm alanlar JSON istek gövdesindedir ve domain alanı eklenmiştir.
Mağaza uygulamayı yeniden kurarsa kurulum akışı baştan çalışır.