İçeriğe geç
App Store

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. 1.Mağaza yöneticisi→App Store

    Uygulamayı kaldırır

  2. 2.App Store→Uninstall Hook URL'niz

    Kaldırma bildirimini gönderir

    POST, JSON gövdesinde username, hash ve domain.

  3. 3.Uninstall Hook URL'niz

    hash'i doğrular ve mağaza verisini siler

  4. 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
POST https://uygulamaniz.example.com/ideasoft/uninstall Content-Type: application/json { "username": "ab0119d06bd5dc4be1748543e1441ceb", "hash": "d5193458e451ae287da4f0b4fe012a67de9a75c62fcb22e50712a62690f9d8d8", "domain": "https://magaza-adiniz.myideasoft.com" }
AlanAçıklama
usernameMağ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).
domainUygulamayı kaldıran mağazanın şemayla birlikte adresi.

Doğrulama

  1. hash değerini gövdedeki username ile yeniden hesaplayın ve sabit zamanlı karşılaştırın. İmzalanan metin PHP json_encode çıktısıdır: {"username":"ab0119d06bd5dc4be1748543e1441ceb"}.
  2. username değerinin md5(domain) ile aynı olduğunu kontrol edin.
  3. Doğrulama başarılıysa mağazaya ait token'ları ve kayıtları silin, ardından HTTP 200 dönün.
<?php $body = json_decode(file_get_contents('php://input'), true) ?: []; $username = (string)($body['username'] ?? ''); $domain = (string)($body['domain'] ?? ''); $secret = getenv('IDEASOFT_CLIENT_SECRET'); $expected = hash_hmac('sha256', json_encode(['username' => $username]), $secret); $validHash = hash_equals($expected, (string)($body['hash'] ?? '')); $validUser = hash_equals(md5($domain), $username); if (!$validHash || !$validUser) { http_response_code(401); exit; } // Mağazaya ait token ve kayıtları silin (zaten silinmişse de 200 dönün) http_response_code(200);

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:

TerminalCode
curl -X POST https://uygulamaniz.example.com/ideasoft/uninstall \ -H 'Content-Type: application/json' \ -d '{"username":"ab0119d06bd5dc4be1748543e1441ceb","hash":"d5193458e451ae287da4f0b4fe012a67de9a75c62fcb22e50712a62690f9d8d8","domain":"https://magaza-adiniz.myideasoft.com"}'

Yanıt ve yeniden deneme

  • Yalnızca HTTP 200 başarılı sayılır. 201, 204 dahil 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.

Son güncelleme: