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