API-referens

Domänövervakningsmeny API-referens

Hantera din domänovervakningslista. Få meddelande när domäner blir tillgängliga eller ändrar status. Använd denna referens för att välja en operation och integrera dess dokumenterade svarskontrakt.

Operationer

GET /v1/watchlist Visa API-referens
POST /v1/watchlist Visa API-referens
DELETE /v1/watchlist Visa API-referens
GET /v1/watchlist/expiring Visa API-referens
GET /v1/watchlist/available Visa API-referens

GET /v1/watchlist

Operation: getWatchlist Credits och autentisering: 1 Autentisering krävs
GET /v1/watchlist

Svarsfält

Fält Typ
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

Exempelbegäran

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

Exempelsvar

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

Operation: addToWatchlist Credits och autentisering: 1 Autentisering krävs
POST /v1/watchlist

Brödtextparametrar

Parameter Typ obligatorisk
domain string obligatorisk
notify_email string valfri

Svarsfält

Fält Typ
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

Exempelbegäran

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]"
}'

Exempelsvar

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

Operation: removeFromWatchlist Credits och autentisering: Gratis Autentisering krävs
DELETE /v1/watchlist

Frågeparametrar

Parameter Typ obligatorisk
domain string obligatorisk

Svarsfält

Fält Typ
success boolean
message string
domain string

Exempelbegäran

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

Exempelsvar

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

GET /v1/watchlist/expiring

Operation: getExpiringWatchlist Credits och autentisering: 1 Autentisering krävs
GET /v1/watchlist/expiring

Frågeparametrar

Parameter Typ obligatorisk
days integer
Standard 90
valfri

Svarsfält

Fält Typ
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

Exempelbegäran

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

Exempelsvar

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

Operation: getAvailableWatchlist Credits och autentisering: 1 Autentisering krävs
GET /v1/watchlist/available

Svarsfält

Fält Typ
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

Exempelbegäran

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

Exempelsvar

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

Referensresurser