> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/tr/docs/watchlist

# Alan Adı İzleme Listesi

Alan adı analizi için DomScan API: Domainleri sona erme ve uygunluk değişiklikleri için izleyin. Kayıtlı domainler uygun olduğunda uyarı alın.

Domainleri sona erme ve uygunluk değişiklikleri için izleyin. Kayıtlı domainler uygun olduğunda uyarı alın.

İzleyebileceğiniz alan adı sayısı planınıza bağlıdır. Ücretsiz hesaplar 5 alan adını izleyebilir. Ücretli hesaplar, aylık plan kredisinin her 30'u için bir alan adını izleyebilir; bu, her alan adının günlük kontrolü için yeterlidir ve en az 100, en fazla 1.000'dir. Aylık planı olmayan ücretli hesaplar 100 alan adı izleyebilir. GET /v1/watchlist geçerli sınırınızı max_domains olarak döndürür. Sınırı aşan bir ekleme, yinelenen kayıt veya geçersiz girdi reddedilir ve kredi harcatmaz.

**İzleme**

Personalize edilen etki alanı izleme listenize, e-posta uyarılarına, web kancalarına ve daha fazlasına erişmek için Google ile oturum açın.

E-posta, Telegram, Slack, Discord veya Webhook yoluyla bildirim alın.

[İzleme](https://domscan.net/tr/monitor)
[Ayarlar](https://domscan.net/tr/monitor/settings)
[Marka İzlemesi](https://domscan.net/tr/brand-monitor-api)

GET /v1/watchlist

İzleme listenizdeki tüm domainleri alın.

#### Örnek yanıt

```json
{
                "watchlist": [
                {
                "domain": "startup.com",
                "added_at": "2024-01-15T10:30:00Z",
                "status": "registered",
                "expiry_date": "2025-01-15T00:00:00Z",
                "days_until_expiry": 287,
                "last_checked": "2024-03-01T12:00:00Z",
                "notify_email": "alerts@example.com",
                "check_count": 4
                }
                ],
                "total": 1,
                "max_domains": 333,
                "limit_basis": "monthly_credits",
                "updated_at": "2024-03-01T12:00:00Z"
                }
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `has_more` | boolean |
| `next_cursor` | string \| null |
| `watchlist[]` | object[] |
| `watchlist[]` | object |
| `watchlist[].domain` | string |
| `watchlist[].added_at` | string |
| `watchlist[].status` | string |
| `watchlist[].last_checked` | string |
| `watchlist[].expiry_date` | string |
| `watchlist[].days_until_expiry` | integer |
| `watchlist[].notify_email` | string |
| `watchlist[].check_count` | integer |
| `total` | integer |
| `max_domains` | integer |
| `limit_basis` | string |
| `updated_at` | string |

POST /v1/watchlist

İzleme listenize bir domain ekleyin.

#### İstek gövdesi

```json
{
                "domain": "mydomain.com",
                "notify_email": "alerts@example.com"
                }
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `success` | boolean |
| `message` | string |
| `watchlist[]` | object[] |
| `watchlist[]` | object |
| `watchlist[].domain` | string |
| `watchlist[].added_at` | string |
| `watchlist[].status` | string |
| `watchlist[].last_checked` | string |
| `watchlist[].expiry_date` | string |
| `watchlist[].days_until_expiry` | integer |
| `watchlist[].notify_email` | string |
| `watchlist[].check_count` | integer |
| `total` | integer |
| `max_domains` | integer |
| `limit_basis` | string |

#### Örnek yanıt

```json
{
  "success": true,
  "message": "Added example.org to watchlist",
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2026-06-02T09:12:00.000Z",
      "last_checked": "2026-10-09T03:00:12.000Z",
      "status": "expiring_soon",
      "expiry_date": "2026-12-18T14:22:08Z",
      "days_until_expiry": 70,
      "notify_email": "alerts@example.com"
    },
    {
      "domain": "example.org",
      "added_at": "2026-10-09T10:15:30.000Z",
      "status": "unknown",
      "notify_email": "alerts@example.com"
    }
  ],
  "total": 2,
  "max_domains": 333,
  "limit_basis": "monthly_credits"
}
```

PATCH /v1/watchlist/:domain

İzleme listenizde zaten bulunan bir alan adının uyarı e-postasını, kaldırıp yeniden eklemeden değiştirin. Silmek için notify_email değerini null olarak gönderin; bu durumda o alan adının uyarıları hesabınızın bildirim adresine gider. Güncellemeler ücretsizdir.

#### İstek gövdesi

```json
{
                "notify_email": "ops@example.com"
                }
```

```bash
curl -X PATCH -H "X-API-Key: your-api-key" -H "Content-Type: application/json"                 -d '{"notify_email":"ops@example.com"}' "https://domscan.net/v1/watchlist/mydomain.com"
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `success` | boolean |
| `message` | string |
| `domain` | object |
| `domain.domain` | string |
| `domain.added_at` | string |
| `domain.status` | string |
| `domain.last_checked` | string |
| `domain.expiry_date` | string |
| `domain.days_until_expiry` | integer |
| `domain.notify_email` | string |
| `domain.check_count` | integer |

#### Örnek yanıt

```json
{
  "success": true,
  "message": "Updated example.com in your watchlist",
  "domain": {
    "domain": "example.com",
    "added_at": "2026-06-02T09:12:00.000Z",
    "status": "registered",
    "notify_email": "ops@example.com",
    "check_count": 12
  }
}
```

DELETE /v1/watchlist?domain=mydomain.com

İzleme listesinden kaldır

```bash
curl -X DELETE -H "X-API-Key: your-api-key" "https://domscan.net/v1/watchlist?domain=mydomain.com"
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `success` | boolean |
| `message` | string |
| `domain` | string |
| `watchlist[]` | object[] |
| `watchlist[]` | object |
| `watchlist[].domain` | string |
| `watchlist[].added_at` | string |
| `watchlist[].status` | string |
| `watchlist[].last_checked` | string |
| `watchlist[].expiry_date` | string |
| `watchlist[].days_until_expiry` | integer |
| `watchlist[].notify_email` | string |
| `watchlist[].check_count` | integer |
| `total` | integer |

#### Örnek yanıt

```json
{
  "success": true,
  "message": "Request completed",
  "domain": "example.com",
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2026-08-27T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-08-27T12:00:00Z",
      "expiry_date": "2026-08-27T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "user@example.com",
      "check_count": 1
    }
  ],
  "total": 1
}
```

GET /v1/watchlist/expiring?days=30

Yakında sona eriyor

#### Örnek yanıt

```json
{
                "expiring_domains": [
                {
                "domain": "renewal-window.com",
                "status": "expiring_soon",
                "expiry_date": "2026-05-12T00:00:00Z",
                "days_until_expiry": 28,
                "check_count": 11
                }
                ],
                "total": 1,
                "threshold_days": 30
                }
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `has_more` | boolean |
| `next_cursor` | string \| null |
| `expiring_domains[]` | object[] |
| `expiring_domains[]` | object |
| `expiring_domains[].domain` | string |
| `expiring_domains[].added_at` | string |
| `expiring_domains[].status` | string |
| `expiring_domains[].last_checked` | string |
| `expiring_domains[].expiry_date` | string |
| `expiring_domains[].days_until_expiry` | integer |
| `expiring_domains[].notify_email` | string |
| `expiring_domains[].check_count` | integer |
| `total` | integer |
| `threshold_days` | integer |

GET /v1/watchlist/available

Müsait

Sayfalanır: `limit` (1 ile 100 arası) gönderin ve `next_cursor` değerini `cursor` olarak geri iletin. Yanıtlar `has_more` ve `next_cursor` içerir. `limit` olmadan tüm liste döndürülür. Bkz. [sayfalama](https://domscan.net/docs/response-format#pagination).

#### Örnek yanıt

```json
{
                "available_domains": [
                {
                "domain": "startupdrop.ai",
                "status": "available",
                "last_checked": "2026-04-14T08:30:00Z",
                "check_count": 18
                }
                ],
                "total": 1,
                "message": "İzleme listenizdeki bu alan adları artık kayıt için müsait!"
                }
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `has_more` | boolean |
| `next_cursor` | string \| null |
| `available_domains[]` | object[] |
| `available_domains[]` | object |
| `available_domains[].domain` | string |
| `available_domains[].added_at` | string |
| `available_domains[].status` | string |
| `available_domains[].last_checked` | string |
| `available_domains[].expiry_date` | string |
| `available_domains[].days_until_expiry` | integer |
| `available_domains[].notify_email` | string |
| `available_domains[].check_count` | integer |
| `total` | integer |
| `message` | string |

### Uyarı webhookları

İzleme uyarılarını kendi HTTPS uç noktalarınızda imzalı JSON POST istekleri olarak alın. Uç noktaları bir API anahtarıyla veya oturum açıkken İzleyici ayarlarından yönetin.

#### Olay türleri

| İzleyici | Olaylar |
| --- | --- |
| İzleme listesi uygunluğu, süre sonu ve durumu | `domain.available`, `domain.expiring_30`, `domain.expiring_14`, `domain.expiring_7`, `domain.expiring_1`, `domain.status_change` |
| Alan adı değişikliği izleme | `domain.dns_changed`, `domain.certificate_changed`, `domain.registration_changed`, `domain.hosting_changed`, `domain.technology_changed`, `domain.email_security_changed` |
| Marka izleme (yeni benzer alan adı kayıtları) | `brand.threat_detected` |
| İzleme listesi uyarı abonelikleri (sertifikalar, fiyatlar, DNS kayıtları, benzer alan adları) | `ssl.expiring`, `ssl.expired`, `ssl.changed`, `price.dropped`, `dns.changed`, `typosquat.detected` |
| Marka değişikliği uyarıları (logolar, renkler, ad, sosyal profiller) | `brand.updated` |
| Eşzamansız işler (ücretsiz, yalnızca notify_webhook ile oluşturulan işler için) | `job.completed`, `job.failed`, `job.cancelled` |
| Test olayı (ücretsiz) | `webhook.test` |

[Webhook uyarıları API rehberini okuyun](https://domscan.net/tr/webhook-alerts-api)

#### Fiyatlandırma

2xx yanıtıyla bir uç noktaya teslim edilen her uyarı 2 kredi tutarındadır. Krediler ilk denemeden hemen önce ayrılır; teslimat başarısız olursa, iptal edilirse veya uç nokta silinirse iade edilir. Test olayları ücretsizdir. Bakiye çok düşükse uyarı atlanır ve ücret alınmaz.

POST /v1/webhooks

Bir HTTPS uç noktası kaydedin. URL herkese açık bir adrese çözümlenmelidir. Tüm olay türlerini almak için events alanını atlayın veya ["*"] gönderin. İmzalama sırrı yalnızca bu yanıtta döndürülür.

#### Örnek istek

```bash
curl -X POST "https://domscan.net/v1/webhooks" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.example.com/domscan",
    "events": ["domain.expiring_30", "domain.available", "domain.dns_changed"]
  }'
```

#### Örnek yanıt

```json
{
  "endpoint": {
    "id": "whe_3f1c0a9b8e7d6c5b4a39281706f5e4d3",
    "url": "https://hooks.example.com/domscan",
    "events": ["domain.available", "domain.expiring_30", "domain.dns_changed"],
    "status": "active",
    "secret_hint": "9c2e"
  },
  "secret": "whsec_..."
}
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `endpoint` | object |
| `endpoint.id` | string |
| `endpoint.url` | string |
| `endpoint.description` | string \| null |
| `endpoint.events[]` | string[] |
| `endpoint.status` | string |
| `endpoint.disabled_reason` | string \| null |
| `endpoint.consecutive_failures` | integer |
| `endpoint.secret_hint` | string |
| `endpoint.previous_secret_expires_at` | string \| null |
| `endpoint.secret_rotated_at` | string \| null |
| `endpoint.last_success_at` | string \| null |
| `endpoint.last_failure_at` | string \| null |
| `endpoint.last_error` | string \| null |
| `endpoint.created_at` | string |
| `endpoint.updated_at` | string |
| `endpoint.disabled_at` | string \| null |
| `secret` | string |

GET /v1/webhooks

Uç noktalarınızı durumları, abone olunan olaylar, hata sayısı ve sırrın son dört karakteriyle birlikte; ayrıca kullanılabilir olay türlerini ve teslimat politikasını listeler.

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `endpoints[]` | object[] |
| `endpoints[]` | object |
| `endpoints[].id` | string |
| `endpoints[].url` | string |
| `endpoints[].description` | string \| null |
| `endpoints[].events[]` | string[] |
| `endpoints[].status` | string |
| `endpoints[].disabled_reason` | string \| null |
| `endpoints[].consecutive_failures` | integer |
| `endpoints[].secret_hint` | string |
| `endpoints[].previous_secret_expires_at` | string \| null |
| `endpoints[].secret_rotated_at` | string \| null |
| `endpoints[].last_success_at` | string \| null |
| `endpoints[].last_failure_at` | string \| null |
| `endpoints[].last_error` | string \| null |
| `endpoints[].created_at` | string |
| `endpoints[].updated_at` | string |
| `endpoints[].disabled_at` | string \| null |
| `available_events[]` | string[] |
| `all_events` | string |
| `test_event` | string |
| `policy` | object |
| `policy.secret_rotation_grace_seconds` | integer |
| `policy.secret_rotation_credits` | integer |
| `policy.credits_per_delivered_alert` | integer |
| `policy.test_event_credits` | integer |
| `policy.job_event_credits` | integer |
| `policy.failed_deliveries_charged` | boolean |
| `policy.max_endpoints` | integer |
| `policy.max_attempts` | integer |
| `policy.disable_after_consecutive_failures` | integer |
| `policy.signature_tolerance_seconds` | integer |

#### Örnek yanıt

```json
{
  "endpoints": [
    {
      "id": "example-id",
      "url": "https://example.com",
      "events": [
        "example"
      ],
      "status": "active",
      "secret_hint": "example",
      "created_at": "2026-08-27T12:00:00Z",
      "description": "example",
      "disabled_reason": "customer",
      "consecutive_failures": 1,
      "previous_secret_expires_at": "2026-08-27T12:00:00Z",
      "secret_rotated_at": "2026-08-27T12:00:00Z",
      "last_success_at": "2026-08-27T12:00:00Z",
      "last_failure_at": "2026-08-27T12:00:00Z",
      "last_error": "example",
      "updated_at": "2026-08-27T12:00:00Z",
      "disabled_at": "2026-08-27T12:00:00Z"
    }
  ],
  "available_events": [
    "domain.available"
  ],
  "policy": {
    "credits_per_delivered_alert": 2,
    "test_event_credits": 0,
    "failed_deliveries_charged": false,
    "max_endpoints": 1,
    "max_attempts": 1,
    "disable_after_consecutive_failures": 1,
    "signature_tolerance_seconds": 1,
    "secret_rotation_grace_seconds": 86400,
    "secret_rotation_credits": 0,
    "job_event_credits": 0
  },
  "all_events": "*",
  "test_event": "webhook.test"
}
```

PATCH /v1/webhooks/:webhook_id

Bir uç noktayı duraklatın veya etkinleştirin, olaylarını değiştirin ya da açıklamasını düzenleyin. Bir uç noktayı etkinleştirmek hata sayısını sıfırlar.

```json
{ "enabled": true, "events": ["*"] }
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `endpoint` | object |
| `endpoint.id` | string |
| `endpoint.url` | string |
| `endpoint.description` | string \| null |
| `endpoint.events[]` | string[] |
| `endpoint.status` | string |
| `endpoint.disabled_reason` | string \| null |
| `endpoint.consecutive_failures` | integer |
| `endpoint.secret_hint` | string |
| `endpoint.previous_secret_expires_at` | string \| null |
| `endpoint.secret_rotated_at` | string \| null |
| `endpoint.last_success_at` | string \| null |
| `endpoint.last_failure_at` | string \| null |
| `endpoint.last_error` | string \| null |
| `endpoint.created_at` | string |
| `endpoint.updated_at` | string |
| `endpoint.disabled_at` | string \| null |

#### Örnek yanıt

```json
{
  "endpoint": {
    "id": "example-id",
    "url": "https://example.com",
    "events": [
      "example"
    ],
    "status": "active",
    "secret_hint": "example",
    "created_at": "2026-08-27T12:00:00Z",
    "description": "example",
    "disabled_reason": "customer",
    "consecutive_failures": 1,
    "previous_secret_expires_at": "2026-08-27T12:00:00Z",
    "secret_rotated_at": "2026-08-27T12:00:00Z",
    "last_success_at": "2026-08-27T12:00:00Z",
    "last_failure_at": "2026-08-27T12:00:00Z",
    "last_error": "example",
    "updated_at": "2026-08-27T12:00:00Z",
    "disabled_at": "2026-08-27T12:00:00Z"
  }
}
```

DELETE /v1/webhooks/:webhook_id

Bir uç noktayı silin. Bekleyen teslimatlar iptal edilir ve ayrılmış krediler iade edilir.

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `id` | string |
| `deleted` | boolean |

#### Örnek yanıt

```json
{
  "id": "example-id",
  "deleted": true
}
```

POST /v1/webhooks/:webhook_id/test

Ücretsiz bir webhook.test olayı gönderir ve sonucu döndürür. Test olayları yeniden denenmez ve otomatik duraklatma sayacına dahil edilmez.

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `delivery` | object |
| `delivery.id` | string |
| `delivery.endpoint_id` | string |
| `delivery.event_id` | string |
| `delivery.event_type` | string |
| `delivery.status` | string |
| `delivery.attempts` | integer |
| `delivery.next_attempt_at` | string \| null |
| `delivery.last_attempt_at` | string \| null |
| `delivery.response_status` | integer \| null |
| `delivery.last_error` | string \| null |
| `delivery.credits_charged` | integer |
| `delivery.refunded` | boolean |
| `delivery.created_at` | string |
| `delivery.delivered_at` | string \| null |
| `delivered` | boolean |

#### Örnek yanıt

```json
{
  "delivery": {
    "id": "example-id",
    "endpoint_id": "example",
    "event_id": "example",
    "event_type": "domain",
    "status": "pending",
    "attempts": 1,
    "next_attempt_at": "2026-08-27T12:00:00Z",
    "last_attempt_at": "2026-08-27T12:00:00Z",
    "response_status": 1,
    "last_error": "example",
    "credits_charged": 1,
    "refunded": false,
    "created_at": "2026-08-27T12:00:00Z",
    "delivered_at": "2026-08-27T12:00:00Z"
  },
  "delivered": false
}
```

POST /v1/webhooks/:webhook_id/rotate-secret

Duraklatılmış olanlar dahil bir uç noktanın imzalama sırrını değiştirir. Yeni sır yalnızca bu yanıtta döndürülür. Sonraki 24 saat boyunca her teslimat hem yeni hem de önceki sırla imzalanır. Rotasyon ücretsizdir.

#### Örnek istek

```bash
curl -X POST "https://domscan.net/v1/webhooks/whe_3f1c0a9b8e7d6c5b4a39281706f5e4d3/rotate-secret" \
  -H "X-API-Key: $DOMSCAN_API_KEY"
```

#### Örnek yanıt

```json
{
  "endpoint": {
    "id": "whe_3f1c0a9b8e7d6c5b4a39281706f5e4d3",
    "status": "active",
    "secret_hint": "4b7a",
    "previous_secret_expires_at": "2026-10-11T12:00:00.000Z"
  },
  "secret": "whsec_...",
  "previous_secret_expires_at": "2026-10-11T12:00:00.000Z",
  "grace_period_seconds": 86400
}
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `endpoint` | object |
| `endpoint.id` | string |
| `endpoint.url` | string |
| `endpoint.description` | string \| null |
| `endpoint.events[]` | string[] |
| `endpoint.status` | string |
| `endpoint.disabled_reason` | string \| null |
| `endpoint.consecutive_failures` | integer |
| `endpoint.secret_hint` | string |
| `endpoint.previous_secret_expires_at` | string \| null |
| `endpoint.secret_rotated_at` | string \| null |
| `endpoint.last_success_at` | string \| null |
| `endpoint.last_failure_at` | string \| null |
| `endpoint.last_error` | string \| null |
| `endpoint.created_at` | string |
| `endpoint.updated_at` | string |
| `endpoint.disabled_at` | string \| null |
| `secret` | string |
| `previous_secret_expires_at` | string |
| `grace_period_seconds` | integer |

GET /v1/webhooks/:webhook_id/deliveries

#### Sorgu parametreleri

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| limit | integer | Döndürülecek teslimat sayısı, 1 ile 100 arasında. Varsayılan 50. |

Son teslimatları durumları, deneme sayıları, HTTP yanıtı, tahsil edilen krediler ve iadelerle birlikte listeler. Teslimat kayıtları 30 gün saklanır.

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `endpoint_id` | string |
| `deliveries[]` | object[] |
| `deliveries[]` | object |
| `deliveries[].id` | string |
| `deliveries[].endpoint_id` | string |
| `deliveries[].event_id` | string |
| `deliveries[].event_type` | string |
| `deliveries[].status` | string |
| `deliveries[].attempts` | integer |
| `deliveries[].next_attempt_at` | string \| null |
| `deliveries[].last_attempt_at` | string \| null |
| `deliveries[].response_status` | integer \| null |
| `deliveries[].last_error` | string \| null |
| `deliveries[].credits_charged` | integer |
| `deliveries[].refunded` | boolean |
| `deliveries[].created_at` | string |
| `deliveries[].delivered_at` | string \| null |

#### Örnek yanıt

```json
{
  "endpoint_id": "example",
  "deliveries": [
    {
      "id": "example-id",
      "endpoint_id": "example",
      "event_id": "example",
      "event_type": "domain",
      "status": "pending",
      "attempts": 1,
      "next_attempt_at": "2026-08-27T12:00:00Z",
      "last_attempt_at": "2026-08-27T12:00:00Z",
      "response_status": 1,
      "last_error": "example",
      "credits_charged": 1,
      "refunded": false,
      "created_at": "2026-08-27T12:00:00Z",
      "delivered_at": "2026-08-27T12:00:00Z"
    }
  ]
}
```

#### İstek biçimi

Her uyarı, JSON gövdeli bir POST isteğidir. id alanı bir olay için sabit kalır ve X-DomScan-Event-Id içinde tekrarlanır; böylece zaten işlediğiniz yeniden denemeleri yok sayabilirsiniz.

```http
POST /domscan HTTP/1.1
Content-Type: application/json
X-DomScan-Event: domain.expiring_30
X-DomScan-Event-Id: evt_6f1d2c3b4a5948e7b6c5d4e3f2a1b0c9
X-DomScan-Timestamp: 1791633600
X-DomScan-Signature: sha256=...

{
  "id": "evt_6f1d2c3b4a5948e7b6c5d4e3f2a1b0c9",
  "type": "domain.expiring_30",
  "created": "2026-10-10T12:00:00.000Z",
  "data": {
    "domain": "acme.io",
    "previous_status": "registered",
    "current_status": "expiring_soon",
    "expiry_date": "2026-11-09T00:00:00Z",
    "days_until_expiry": 30,
    "checked_at": "2026-10-10T12:00:00.000Z"
  }
}
```

#### İmzaları doğrulayın

Uç noktanızın sırrını kullanarak X-DomScan-Timestamp değerinin, bir noktanın ve ham istek gövdesinin HMAC-SHA256 değerini hesaplayın. Sonucu X-DomScan-Signature ile sabit zamanlı karşılaştırın ve zaman damgası 5 dakikadan eski olan istekleri reddedin.

Aşağıdaki örnek başlıktaki her imzayı kontrol eder, bu yüzden sır rotasyonu sırasında da çalışmaya devam eder.

```javascript
import crypto from 'node:crypto';

// rawBody: the request body exactly as received, before JSON parsing.
function verifyDomScanWebhook(rawBody, headers, secret) {
  const timestamp = headers['x-domscan-timestamp'];
  const header = headers['x-domscan-signature'] || '';
  if (!/^\d{10}$/.test(timestamp || '')) return false;
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
  const expected = Buffer.from('sha256=' + crypto
    .createHmac('sha256', secret)
    .update(timestamp + '.' + rawBody)
    .digest('hex'));
  // One entry normally; two during a secret rotation (new secret first).
  return header.split(',').some((entry) => {
    const candidate = Buffer.from(entry.trim());
    return candidate.length === expected.length &&
      crypto.timingSafeEqual(candidate, expected);
  });
}
```

#### İmzalama sırrını yenileyin

Rotasyondan sonraki 24 saatlik geçiş süresinde X-DomScan-Signature, aşağıda gösterildiği gibi virgülle ayrılmış iki imza içerir ve yeni sır ilk sıradadır. Herhangi bir girdi güvendiğiniz bir sırla eşleştiğinde isteği kabul edin, yeni sırrı devreye alın, ardından eskisine güvenmeyi bırakın. Geçiş süresi içinde yeniden rotasyon yaparsanız eski önceki sır hemen devre dışı kalır.

```http
X-DomScan-Signature: sha256=<new>,sha256=<previous>
```

#### Yeniden denemeler ve otomatik duraklatma

Bir uyarıyı onaylamak için 8 saniye içinde herhangi bir 2xx durumu döndürün. Yönlendirmeler, diğer durum kodları ve zaman aşımları üstel geri çekilmeyle (1, 4, 16, 64 ve 256 dakika) toplamda en fazla 6 denemeye kadar yeniden denenir. Art arda 15 başarısız denemeden sonra uç nokta duraklatılır; PATCH ile veya İzleyici ayarlarından yeniden etkinleştirin.

Bir uç nokta tekrarlanan hatalar nedeniyle duraklatıldığında, uç noktanın sahibi uç nokta ana makinesini, son hatayı ve İzleme ayarlarına giden bir bağlantıyı içeren tek bir e-posta alır. Uç noktayı düzeltin, ardından İzleme ayarlarından veya enabled değeri true olan PATCH ile yeniden etkinleştirin. Etkinleştirme, hata sayacını sıfıra döndürür.

### İzleme listesi uyarı abonelikleri

İzlenen bir öğeyi almak istediğiniz uyarılara abone edin. Her abonelik tek bir ana makine adını, TLD'yi veya marka alan adını izler ve hangi olayları alacağınızı siz seçersiniz. Olaylar imzalı webhook uç noktalarınıza ve uygulama içi uyarılarınıza gönderilir.

| Tür | Olaylar | Ne zaman tetiklenir |
| --- | --- | --- |
| `ssl` | `ssl.expiring`, `ssl.expired`, `ssl.changed` | ssl.expiring, bir ana makine adının sunduğu sertifikanın süresi ssl_expiring_days içinde dolacağında tetiklenir (30, 14, 7 veya 1, varsayılan 14); sertifika ve eşik başına bir kez. ssl.expired, süresi dolan her sertifika için bir kez. ssl.changed, art arda iki kontrolde yeni bir sertifika parmak izi görüldüğünde; payload, vericinin değişip değişmediğini belirtir. |
| `price` | `price.dropped` | Bir TLD'nin kayıt veya yenileme fiyatı, tek bir kayıt kuruluşunda ya da en ucuzunda, son uyarıdan bu yana görülen en yüksek fiyata göre en az drop_percent kadar düştüğünde veya target_price değerine ya da altına indiğinde. Fiyatlar günlük fiyat anlık görüntüsünden gelir ve her anlık görüntü bir kez değerlendirilir. |
| `dns` | `dns.changed` | Herhangi bir ana makine adının izlenen kayıt türü (A, AAAA, MX, NS, TXT veya CNAME), art arda iki doğrulanmış sorguda aynı yeni yanıtı döndürdüğünde. |
| `typosquat` | `typosquat.detected` | Marka alan adının benzeri yeni kaydedildiğinde; bu durum yetkili bir kayıt sorgusuyla doğrulanır. Benzer alan adları üzerindeki ilk tam tarama başlangıç durumunu belirler ve uyarı göndermez. |
| `brand` | `brand.updated` | Bir marka alan adının kare logosu, geniş logosu, renkleri, adı veya bildirilen sosyal profilleri değiştiğinde ve değişiklik bir sonraki kontrolde yeniden görüldüğünde. Hangilerinin izleneceğini attributes ile seçin (logo, wide_logo, colors, name, socials; varsayılan olarak hepsi). İlk kontrol başlangıç noktasını belirler ve uyarı göndermez; kontrol edilemeyen bir öznitelik değişmemiş sayılır. |

Yalnızca kesin kanıt bir olayı tetikler. Başarısız bir TLS el sıkışması, başarısız olan veya zaman aşımına uğrayan bir DNS sorgusu, eksik bir fiyat ve engellenen ya da hız sınırına takılan bir sorgu bilinmeyen sayılır: hiçbir şeyi değiştirmez, asla uyarı vermez ve ücret almaz. Bir aboneliğin ilk doğrulanmış kontrolü başlangıç durumunu belirler.

Kontroller otomatik çalışır: sertifikalar her 12 saatte, DNS kayıtları her saat (bir değişiklik ilk görüldükten 15 dakika sonra doğrulama kontrolüyle), fiyatlar günlük anlık görüntüye göre her 2 saatte ve benzer alan adları 30'luk gruplar halinde, her gün tam bir taramayla. Bilinmeyen bir kontrolden sonra bir sonraki deneme daha erken yapılır. Marka abonelikleri günde bir kez kontrol edilir; bir değişiklik ilk görüldükten 90 dakika sonra doğrulama kontrolü yapılır.

Abonelik oluşturmak ve kontrol çalıştırmak ücretsizdir. 2xx yanıtıyla bir webhook uç noktasına teslim edilen her uyarı, diğer tüm izleme uyarıları gibi 2 kredi tutarındadır. Başarısız teslimatların kredisi iade edilir ve bir hesapta en fazla 100 abonelik olabilir; bunların 20'si benzer alan adları içindir.

POST /v1/watchlist/alerts

Abonelik oluşturun. type hangi alanların geçerli olduğunu belirler: ssl, dns ve typosquat için domain; price için tld, registrar, price_type, drop_percent ve target_price. Türe uymayan alanlar reddedilir.

#### İstek gövdesi

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| type | string | ssl, price, dns veya typosquat. Zorunludur. |
| domain | string | ssl ve dns için izlenecek ana makine adı veya typosquat için marka alan adı. |
| tld | string | price için izlenecek TLD, örneğin com. |
| registrar | string | price için kayıt kuruluşu kimliği. En ucuz kayıt kuruluşunu izlemek için boş bırakın. |
| events | string[] | Alınacak olaylar. Varsayılan olarak türün tüm olaylarıdır. |
| ssl_expiring_days | integer | ssl.expiring için süre dolmadan önceki gün sayısı: 30, 14, 7 veya 1. Varsayılan 14. |
| price_type | string | registration (varsayılan) veya renewal. |
| drop_percent | number | En az bu yüzdede bir düşüşte uyar, 1 ile 95 arası. |
| target_price | number | USD cinsinden fiyat bu tutara veya altına indiğinde uyar. Fiyat aboneliği için drop_percent, target_price veya her ikisi gerekir. |
| record_types | string[] | dns için izlenecek kayıt türleri. Varsayılan A, AAAA, MX, NS, TXT ve CNAME. |
| notify_email | string | İsteğe bağlı. Bu aboneliğin her uyarısını ayrıca bu adrese e-postayla gönderir (gönderilen her e-posta için 3 kredi). Webhook teslimi değişmez. Daha sonra PATCH ile değiştirin veya e-postaları durdurmak için null gönderin. |

#### Örnek istek

```bash
curl -X POST "https://domscan.net/v1/watchlist/alerts" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "price",
    "tld": "com",
    "registrar": "porkbun",
    "price_type": "renewal",
    "drop_percent": 10,
    "target_price": 9.5
  }'
```

#### Örnek yanıt

```json
{
  "subscription": {
    "id": "mas_8c1f0e2d3b4a59687766554433221100",
    "type": "price",
    "target": "com",
    "registrar": "porkbun",
    "events": ["price.dropped"],
    "status": "active",
    "price_type": "renewal",
    "drop_percent": 10,
    "target_price": 9.5,
    "currency": "USD",
    "observed": null,
    "last_check_status": null,
    "next_check_at": "2026-10-10T12:00:00.000Z"
  }
}
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `subscription` | object |
| `subscription.id` | string |
| `subscription.type` | string |
| `subscription.target` | string |
| `subscription.registrar` | string \| null |
| `subscription.events[]` | string[] |
| `subscription.status` | string |
| `subscription.ssl_expiring_days` | integer \| null |
| `subscription.price_type` | string \| null |
| `subscription.drop_percent` | number \| null |
| `subscription.target_price` | number \| null |
| `subscription.currency` | string \| null |
| `subscription.record_types[]` | string[] |
| `subscription.attributes[]` | string[] |
| `subscription.notify_email` | string \| null |
| `subscription.observed` | object \| null |
| `subscription.last_check_at` | string \| null |
| `subscription.last_check_status` | string \| null |
| `subscription.last_error` | string \| null |
| `subscription.next_check_at` | string \| null |
| `subscription.created_at` | string |
| `subscription.updated_at` | string |

GET /v1/watchlist/alerts

Aboneliklerinizi, son doğrulanmış kanıtları ve kontrol durumuyla, her türün desteklediği olayları, kontrol takvimini ve uyarı fiyatını birlikte listeleyin.

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `subscriptions[]` | object[] |
| `subscriptions[]` | object |
| `subscriptions[].id` | string |
| `subscriptions[].type` | string |
| `subscriptions[].target` | string |
| `subscriptions[].registrar` | string \| null |
| `subscriptions[].events[]` | string[] |
| `subscriptions[].status` | string |
| `subscriptions[].ssl_expiring_days` | integer \| null |
| `subscriptions[].price_type` | string \| null |
| `subscriptions[].drop_percent` | number \| null |
| `subscriptions[].target_price` | number \| null |
| `subscriptions[].currency` | string \| null |
| `subscriptions[].record_types[]` | string[] |
| `subscriptions[].attributes[]` | string[] |
| `subscriptions[].notify_email` | string \| null |
| `subscriptions[].observed` | object \| null |
| `subscriptions[].last_check_at` | string \| null |
| `subscriptions[].last_check_status` | string \| null |
| `subscriptions[].last_error` | string \| null |
| `subscriptions[].next_check_at` | string \| null |
| `subscriptions[].created_at` | string |
| `subscriptions[].updated_at` | string |
| `total` | integer |
| `available_types` | object |
| `available_types.ssl[]` | string[] |
| `available_types.price[]` | string[] |
| `available_types.dns[]` | string[] |
| `available_types.typosquat[]` | string[] |
| `available_types.brand[]` | string[] |
| `policy` | object |
| `policy.credits_per_delivered_alert` | integer |
| `policy.check_credits` | integer |
| `policy.unknown_checks_charged` | boolean |
| `policy.max_subscriptions` | integer |
| `policy.max_typosquat_subscriptions` | integer |
| `policy.max_brand_subscriptions` | integer |
| `policy.brand_attributes[]` | string[] |
| `policy.ssl_expiring_days[]` | integer[] |
| `policy.default_ssl_expiring_days` | integer |
| `policy.record_types[]` | string[] |
| `policy.price_types[]` | string[] |
| `policy.check_interval_minutes` | object |
| `policy.confirmation_checks` | object |

#### Örnek yanıt

```json
{
  "subscriptions": [
    {
      "id": "example-id",
      "type": "ssl",
      "target": "example",
      "registrar": "example",
      "events": [
        "ssl.expiring"
      ],
      "status": "active",
      "ssl_expiring_days": 30,
      "price_type": "registration",
      "drop_percent": 0.5,
      "target_price": 0.5,
      "currency": "USD",
      "record_types": [
        "A"
      ],
      "attributes": [
        "logo"
      ],
      "notify_email": "user@example.com",
      "observed": {},
      "last_check_at": "2026-08-27T12:00:00Z",
      "last_check_status": "baseline",
      "last_error": "example",
      "next_check_at": "2026-08-27T12:00:00Z",
      "created_at": "2026-08-27T12:00:00Z",
      "updated_at": "2026-08-27T12:00:00Z"
    }
  ],
  "total": 1,
  "available_types": {
    "ssl": [
      "ssl.expiring"
    ],
    "price": [
      "price.dropped"
    ],
    "dns": [
      "dns.changed"
    ],
    "typosquat": [
      "typosquat.detected"
    ],
    "brand": [
      "brand.updated"
    ]
  },
  "policy": {
    "credits_per_delivered_alert": 2,
    "check_credits": 0,
    "unknown_checks_charged": false,
    "max_subscriptions": 1,
    "check_interval_minutes": {},
    "max_typosquat_subscriptions": 1,
    "max_brand_subscriptions": 1,
    "brand_attributes": [
      "logo"
    ],
    "ssl_expiring_days": [
      1
    ],
    "default_ssl_expiring_days": 1,
    "record_types": [
      "A"
    ],
    "price_types": [
      "registration"
    ],
    "confirmation_checks": {}
  }
}
```

GET /v1/watchlist/alerts/:subscription_id

Tek bir aboneliği son doğrulanmış kanıtı ve en son 20 olayıyla birlikte alın.

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `subscription` | object |
| `subscription.id` | string |
| `subscription.type` | string |
| `subscription.target` | string |
| `subscription.registrar` | string \| null |
| `subscription.events[]` | string[] |
| `subscription.status` | string |
| `subscription.ssl_expiring_days` | integer \| null |
| `subscription.price_type` | string \| null |
| `subscription.drop_percent` | number \| null |
| `subscription.target_price` | number \| null |
| `subscription.currency` | string \| null |
| `subscription.record_types[]` | string[] |
| `subscription.attributes[]` | string[] |
| `subscription.notify_email` | string \| null |
| `subscription.observed` | object \| null |
| `subscription.last_check_at` | string \| null |
| `subscription.last_check_status` | string \| null |
| `subscription.last_error` | string \| null |
| `subscription.next_check_at` | string \| null |
| `subscription.created_at` | string |
| `subscription.updated_at` | string |
| `events[]` | object[] |
| `events[]` | object |
| `events[].id` | string |
| `events[].event_type` | string |
| `events[].detected_at` | string |
| `events[].published_at` | string \| null |
| `events[].data` | object |

#### Örnek yanıt

```json
{
  "subscription": {
    "id": "example-id",
    "type": "ssl",
    "target": "example",
    "registrar": "example",
    "events": [
      "ssl.expiring"
    ],
    "status": "active",
    "ssl_expiring_days": 30,
    "price_type": "registration",
    "drop_percent": 0.5,
    "target_price": 0.5,
    "currency": "USD",
    "record_types": [
      "A"
    ],
    "attributes": [
      "logo"
    ],
    "notify_email": "user@example.com",
    "observed": {},
    "last_check_at": "2026-08-27T12:00:00Z",
    "last_check_status": "baseline",
    "last_error": "example",
    "next_check_at": "2026-08-27T12:00:00Z",
    "created_at": "2026-08-27T12:00:00Z",
    "updated_at": "2026-08-27T12:00:00Z"
  },
  "events": [
    {
      "id": "example-id",
      "event_type": "ssl.expiring",
      "detected_at": "2026-08-27T12:00:00Z",
      "published_at": "2026-08-27T12:00:00Z",
      "data": {}
    }
  ]
}
```

PATCH /v1/watchlist/alerts/:subscription_id

Bir aboneliği enabled ile duraklatın veya sürdürün ya da events, ssl_expiring_days, drop_percent, target_price veya record_types değerlerini değiştirin. Yeni bir hedef fiyat yalnızca sonraki bir fiyat hareketinde uyarı verir.

```json
{ "enabled": false }
```

```json
{ "notify_email": "security@example.com" }
```

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `subscription` | object |
| `subscription.id` | string |
| `subscription.type` | string |
| `subscription.target` | string |
| `subscription.registrar` | string \| null |
| `subscription.events[]` | string[] |
| `subscription.status` | string |
| `subscription.ssl_expiring_days` | integer \| null |
| `subscription.price_type` | string \| null |
| `subscription.drop_percent` | number \| null |
| `subscription.target_price` | number \| null |
| `subscription.currency` | string \| null |
| `subscription.record_types[]` | string[] |
| `subscription.attributes[]` | string[] |
| `subscription.notify_email` | string \| null |
| `subscription.observed` | object \| null |
| `subscription.last_check_at` | string \| null |
| `subscription.last_check_status` | string \| null |
| `subscription.last_error` | string \| null |
| `subscription.next_check_at` | string \| null |
| `subscription.created_at` | string |
| `subscription.updated_at` | string |

#### Örnek yanıt

```json
{
  "subscription": {
    "id": "example-id",
    "type": "ssl",
    "target": "example",
    "registrar": "example",
    "events": [
      "ssl.expiring"
    ],
    "status": "active",
    "ssl_expiring_days": 30,
    "price_type": "registration",
    "drop_percent": 0.5,
    "target_price": 0.5,
    "currency": "USD",
    "record_types": [
      "A"
    ],
    "attributes": [
      "logo"
    ],
    "notify_email": "user@example.com",
    "observed": {},
    "last_check_at": "2026-08-27T12:00:00Z",
    "last_check_status": "baseline",
    "last_error": "example",
    "next_check_at": "2026-08-27T12:00:00Z",
    "created_at": "2026-08-27T12:00:00Z",
    "updated_at": "2026-08-27T12:00:00Z"
  }
}
```

DELETE /v1/watchlist/alerts/:subscription_id

Bir aboneliği silin. Henüz gönderilmemiş olaylar atılır ve asla ücretlendirilmez.

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `id` | string |
| `deleted` | boolean |

#### Örnek yanıt

```json
{
  "id": "example-id",
  "deleted": true
}
```

#### Örnek dns.changed olayı

```json
{
  "id": "evt_2b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e",
  "type": "dns.changed",
  "created": "2026-10-10T12:15:00.000Z",
  "data": {
    "domain": "partner-shop.example",
    "changes": [
      {
        "record_type": "MX",
        "before": ["10 mx1.mail.example"],
        "after": ["10 mx.other-mail.example"],
        "added": ["10 mx.other-mail.example"],
        "removed": ["10 mx1.mail.example"],
        "first_seen_at": "2026-10-10T12:00:00.000Z"
      }
    ],
    "confirmed_checks": 2,
    "confirmed_at": "2026-10-10T12:15:00.000Z",
    "subscription_id": "mas_8c1f0e2d3b4a59687766554433221100"
  }
}
```
