Geliştirici referansı

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.

Alan Adı İzleme Listesi

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.

GET /v1/watchlist

İzleme listenizdeki tüm domainleri alın.

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.

Örnek yanıt

{
                "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": "[email protected]",
                "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

{
                "domain": "mydomain.com",
                "notify_email": "[email protected]"
                }

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

{
  "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": "[email protected]"
    },
    {
      "domain": "example.org",
      "added_at": "2026-10-09T10:15:30.000Z",
      "status": "unknown",
      "notify_email": "[email protected]"
    }
  ],
  "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

{
                "notify_email": "[email protected]"
                }
curl -X PATCH -H "X-API-Key: your-api-key" -H "Content-Type: application/json"                 -d '{"notify_email":"[email protected]"}' "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

{
  "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": "[email protected]",
    "check_count": 12
  }
}
DELETE /v1/watchlist?domain=mydomain.com

İzleme listesinden kaldır

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

{
  "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": "[email protected]",
      "check_count": 1
    }
  ],
  "total": 1
}
GET /v1/watchlist/expiring?days=30

Yakında sona eriyor

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.

Örnek yanıt

{
                "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.

Örnek yanıt

{
                "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

İzleyiciOlaylar
İzleme listesi uygunluğu, süre sonu ve durumudomain.available domain.expiring_30 domain.expiring_14 domain.expiring_7 domain.expiring_1 domain.status_change
Alan adı değişikliği izlemedomain.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

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

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

{
  "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

{
  "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.

{ "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

{
  "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

{
  "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

{
  "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

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

Örnek yanıt

{
  "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

ParametreTürAçı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

{
  "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.

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.

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.

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ürOlaylarNe zaman tetiklenir
sslssl.expiring ssl.expired ssl.changedssl.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.
priceprice.droppedBir 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.
dnsdns.changedHerhangi 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.
typosquattyposquat.detectedMarka 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.
brandbrand.updatedBir 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

ParametreTürAçıklama
typestringssl, price, dns veya typosquat. Zorunludur.
domainstringssl ve dns için izlenecek ana makine adı veya typosquat için marka alan adı.
tldstringprice için izlenecek TLD, örneğin com.
registrarstringprice için kayıt kuruluşu kimliği. En ucuz kayıt kuruluşunu izlemek için boş bırakın.
eventsstring[]Alınacak olaylar. Varsayılan olarak türün tüm olaylarıdır.
ssl_expiring_daysintegerssl.expiring için süre dolmadan önceki gün sayısı: 30, 14, 7 veya 1. Varsayılan 14.
price_typestringregistration (varsayılan) veya renewal.
drop_percentnumberEn az bu yüzdede bir düşüşte uyar, 1 ile 95 arası.
target_pricenumberUSD cinsinden fiyat bu tutara veya altına indiğinde uyar. Fiyat aboneliği için drop_percent, target_price veya her ikisi gerekir.
record_typesstring[]dns için izlenecek kayıt türleri. Varsayılan A, AAAA, MX, NS, TXT ve CNAME.
notify_emailstringİ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

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

{
  "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

{
  "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": "[email protected]",
      "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

{
  "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": "[email protected]",
    "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.

{ "enabled": false }
{ "notify_email": "[email protected]" }

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

{
  "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": "[email protected]",
    "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

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

Örnek dns.changed olayı

{
  "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"
  }
}