API referansı

Domain İzleme Listesi API ürünü

Alan izleme listesini yönetin. Alanlar kullanılabilir hale geldiğinde veya durum değiştiğinde bildirim alın. Bir işlem seçmek ve belgelenen yanıt sözleşmesini entegre etmek için bu referansı kullanın.

Ürün sayfasını görüntüle

İşlemler

GET /v1/watchlist API referansını görüntüle

POST /v1/watchlist API referansını görüntüle

DELETE /v1/watchlist API referansını görüntüle

GET /v1/watchlist/expiring API referansını görüntüle

GET /v1/watchlist/available API referansını görüntüle

GET `/v1/watchlist`

İşlem: getWatchlist Krediler ve kimlik doğrulama: 1 Kimlik doğrulama gerekli

GET /v1/watchlist

Yanıt Alanları

Alan	Tür
`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
`total`	integer
`updated_at`	string

Örnek İstek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist"

Örnek Yanıt

{
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2024-01-01T00:00:00Z",
      "status": "registered",
      "last_checked": "2024-01-15T12:00:00Z"
    }
  ],
  "total": 1,
  "updated_at": "2024-01-15T12:00:00Z"
}

POST `/v1/watchlist`

İşlem: addToWatchlist Krediler ve kimlik doğrulama: 1 Kimlik doğrulama gerekli

POST /v1/watchlist

Gövde Parametreleri

Parametre	Tür	gerekli
domain	string	gerekli
notify_email	string	isteğe bağlı

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
`total`	integer

Örnek İstek

curl -X POST "https://domscan.net/v1/watchlist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domain": "example.com",
  "notify_email": "[email protected]"
}'

Örnek Yanıt

{
  "success": true,
  "message": "string",
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2026-04-15T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "total": 1
}

DELETE `/v1/watchlist`

İşlem: removeFromWatchlist Krediler ve kimlik doğrulama: Ücretsiz Kimlik doğrulama gerekli

DELETE /v1/watchlist

Sorgu Parametreleri

Parametre	Tür	gerekli
domain	string	gerekli

Yanıt Alanları

Alan	Tür
`success`	boolean
`message`	string
`domain`	string

Örnek İstek

curl -X DELETE "https://domscan.net/v1/watchlist?domain=example.com" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'

Örnek Yanıt

{
  "success": true,
  "message": "string",
  "domain": "example.com"
}

GET `/v1/watchlist/expiring`

İşlem: getExpiringWatchlist Krediler ve kimlik doğrulama: 1 Kimlik doğrulama gerekli

GET /v1/watchlist/expiring

Sorgu Parametreleri

Parametre	Tür	gerekli
days	integer Varsayılan `90`	isteğe bağlı

Yanıt Alanları

Alan	Tür
`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
`total`	integer
`threshold_days`	integer

Örnek İstek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist/expiring?days=example.com"

Örnek Yanıt

{
  "expiring_domains": [
    {
      "domain": "example.com",
      "added_at": "2026-04-15T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "total": 1,
  "threshold_days": 1
}

GET `/v1/watchlist/available`

İşlem: getAvailableWatchlist Krediler ve kimlik doğrulama: 1 Kimlik doğrulama gerekli

GET /v1/watchlist/available

Yanıt Alanları

Alan	Tür
`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
`total`	integer
`message`	string

Örnek İstek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist/available"

Örnek Yanıt

{
  "available_domains": [
    {
      "domain": "example.com",
      "added_at": "2026-04-15T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "total": 1,
  "message": "string"
}

Referans kaynakları

OpenAPI 3.0 Postman MCP