# 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.

<Steps>
  <Step from="merchant" to="appstore" title="Uygulamayı kaldırır" />
  <Step from="appstore" to="hook" title="Kaldırma bildirimini gönderir">
    `POST`, JSON gövdesinde `username`, `hash` ve `domain`.
  </Step>
  <Step from="hook" title="hash'i doğrular ve mağaza verisini siler" />
  <Step from="hook" to="appstore" title="HTTP 200 döner">
    200 dışındaki yanıtlarda bildirim sınırlı sayıda yeniden denenir.
  </Step>
</Steps>

## İstek

```http
POST https://uygulamaniz.example.com/ideasoft/uninstall
Content-Type: application/json

{
  "username": "ab0119d06bd5dc4be1748543e1441ceb",
  "hash": "d5193458e451ae287da4f0b4fe012a67de9a75c62fcb22e50712a62690f9d8d8",
  "domain": "https://magaza-adiniz.myideasoft.com"
}
```

| 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

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.

<CodeTabs>

```php title="PHP"
<?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);
```

```js title="Node.js"
import crypto from "node:crypto";

// ideasoftHmac ve safeEqual yardımcıları: Kurulum ve Yetkilendirme sayfasındaki örnekle aynı
export function verifyUninstall(body, clientSecret) {
  const username = String(body.username ?? "");
  const expected = ideasoftHmac({ username }, clientSecret);
  const md5 = crypto.createHash("md5").update(String(body.domain ?? "")).digest("hex");
  return safeEqual(expected, body.hash ?? "") && safeEqual(md5, username);
}
```

```python title="Python"
# ideasoft_hmac yardımcısı: Kurulum ve Yetkilendirme sayfasındaki örnekle aynı
def verify_uninstall(body, client_secret):
    username = str(body.get("username", ""))
    expected = ideasoft_hmac({"username": username}, client_secret)
    md5 = hashlib.md5(str(body.get("domain", "")).encode()).hexdigest()
    valid_hash = hmac.compare_digest(expected, str(body.get("hash", "")))
    return valid_hash and hmac.compare_digest(md5, username)
```

</CodeTabs>

**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:

```bash
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.

:::note{title="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ışı](/app-store/installation) baştan çalışır.
