> 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/sv/docs/watchlist

# Domänövervakning

DomScan API för domänanalys: Övervaka domäner för förfallotid och tillgänglighetsändringar. Få aviseringar när registrerade domäner blir tillgängliga.

Övervaka domäner för förfallotid och tillgänglighetsändringar. Få aviseringar när registrerade domäner blir tillgängliga.

Hur många domäner du kan bevaka beror på din plan. Gratiskonton kan bevaka 5 domäner. Betalkonton kan bevaka en domän per 30 krediter i månadsplanen, tillräckligt för en daglig kontroll av varje domän, med minst 100 och högst 1 000. Betalkonton utan månadsplan kan bevaka 100. GET /v1/watchlist returnerar din nuvarande gräns som max_domains. Ett tillägg över gränsen, en dubblett eller ogiltig inmatning avvisas och kostar inga krediter.

**Övervakning**

Logga in med Google för att få tillgång till din personliga domänbevakningslista med e-postaviseringar, webhookar med mera.

Ta emot meddelanden via e-post, Telegram, Slack, Discord eller Webhook.

[Övervakning](https://domscan.net/sv/monitor)
[Inställningar](https://domscan.net/sv/monitor/settings)
[Varumärkesövervakning](https://domscan.net/sv/brand-monitor-api)

GET /v1/watchlist

Hämta alla domäner i din övervakningsmeny.

#### Exempelsvar

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

#### Svarsfält

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

Lägg till en domän i din övervakningsmeny.

#### Begärandekropp

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

#### 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 |
| `watchlist[].check_count` | integer |
| `total` | integer |
| `max_domains` | integer |
| `limit_basis` | string |

#### Exempelsvar

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

Ändra aviserings-e-posten för en domän som redan finns i din bevakningslista, utan att ta bort den och lägga till den igen. Skicka notify_email som null för att rensa den, så skickas aviseringar för den domänen till kontots aviseringsadress. Uppdateringar är gratis.

#### Begärandekropp

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

#### Svarsfält

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

#### Exempelsvar

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

Ta bort från bevakningslista

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

#### Svarsfält

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

#### Exempelsvar

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

Löper snart ut

#### Exempelsvar

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

#### Svarsfält

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

Tillgänglig

Paginerad: skicka `limit` (1 till 100) och lämna tillbaka `next_cursor` som `cursor`. Svaren innehåller `has_more` och `next_cursor`. Utan `limit` returneras hela listan. Se [paginering](https://domscan.net/docs/response-format#pagination).

#### Exempelsvar

```json
{
                "available_domains": [
                {
                "domain": "startupdrop.ai",
                "status": "available",
                "last_checked": "2026-04-14T08:30:00Z",
                "check_count": 18
                }
                ],
                "total": 1,
                "message": "Dessa domäner från din bevakningslista är nu tillgängliga för registrering!"
                }
```

#### Svarsfält

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

### Webhooks för varningar

Ta emot övervakningsvarningar som signerade JSON-POST-begäranden till dina egna HTTPS-endpoints. Hantera endpoints med en API-nyckel, eller från inställningarna för Övervakning när du är inloggad.

#### Händelsetyper

| Övervakning | Händelser |
| --- | --- |
| Tillgänglighet, utgångsdatum och status för bevakningslistan | `domain.available`, `domain.expiring_30`, `domain.expiring_14`, `domain.expiring_7`, `domain.expiring_1`, `domain.status_change` |
| Övervakning av domänändringar | `domain.dns_changed`, `domain.certificate_changed`, `domain.registration_changed`, `domain.hosting_changed`, `domain.technology_changed`, `domain.email_security_changed` |
| Varumärkesövervakning (nya liknande registreringar) | `brand.threat_detected` |
| Aviseringsprenumerationer för bevakningslista (certifikat, priser, DNS-poster, förväxlingsbara domäner) | `ssl.expiring`, `ssl.expired`, `ssl.changed`, `price.dropped`, `dns.changed`, `typosquat.detected` |
| Aviseringar om varumärkesändringar (logotyper, färger, namn, sociala profiler) | `brand.updated` |
| Asynkrona jobb (gratis, endast för jobb som skapats med notify_webhook) | `job.completed`, `job.failed`, `job.cancelled` |
| Testhändelse (gratis) | `webhook.test` |

[Läs guiden till API:et för webhook-varningar](https://domscan.net/sv/webhook-alerts-api)

#### Priser

Varje varning som levereras till en endpoint med ett 2xx-svar kostar 2 krediter. Krediterna reserveras strax före det första försöket och återbetalas om leveransen misslyckas, avbryts eller endpointen tas bort. Testhändelser är gratis. Om saldot är för lågt hoppas varningen över och ingenting debiteras.

POST /v1/webhooks

Registrera en HTTPS-endpoint. URL:en måste gå att slå upp till en offentlig adress. Utelämna events, eller skicka ["*"], för att ta emot alla händelsetyper. Signeringshemligheten returneras bara i det här svaret.

#### Exempelbegäran

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

#### Exempelsvar

```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_..."
}
```

#### Svarsfält

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

Lista dina endpoints med status, prenumererade händelser, antal fel och de fyra sista tecknen i hemligheten, tillsammans med tillgängliga händelsetyper och leveranspolicyn.

#### Svarsfält

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

#### Exempelsvar

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

Pausa eller aktivera en endpoint, ändra dess händelser eller redigera beskrivningen. När en endpoint aktiveras nollställs dess felräknare.

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

#### Svarsfält

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

#### Exempelsvar

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

Ta bort en endpoint. Väntande leveranser avbryts och eventuella reserverade krediter återbetalas.

#### Svarsfält

| Fält | Typ |
| --- | --- |
| `id` | string |
| `deleted` | boolean |

#### Exempelsvar

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

POST /v1/webhooks/:webhook_id/test

Skicka en gratis webhook.test-händelse och returnera resultatet. Testhändelser försöks inte igen och räknas inte mot automatisk pausning.

#### Svarsfält

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

#### Exempelsvar

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

Byt ut signeringshemligheten för en endpoint, även en pausad. Den nya hemligheten returneras bara i det här svaret. Under de följande 24 timmarna signeras varje leverans med både den nya och den tidigare hemligheten. Rotation är kostnadsfri.

#### Exempelbegäran

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

#### Exempelsvar

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

#### Svarsfält

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

#### Frågeparametrar

| Parameter | Typ | Description |
| --- | --- | --- |
| limit | integer | Antal leveranser att returnera, från 1 till 100. Standard är 50. |

Lista senaste leveranser med status, försök, HTTP-svar, debiterade krediter och återbetalningar. Leveransposter sparas i 30 dagar.

#### Svarsfält

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

#### Exempelsvar

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

#### Begärans format

Varje varning är en POST-begäran med JSON-innehåll. Fältet id är detsamma för en händelse och upprepas i X-DomScan-Event-Id, så att du kan ignorera omförsök som du redan har behandlat.

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

#### Verifiera signaturer

Beräkna en HMAC-SHA256 av värdet i X-DomScan-Timestamp, en punkt och begärans råa innehåll med din endpoints hemlighet. Jämför resultatet med X-DomScan-Signature i konstant tid och avvisa begäranden vars tidsstämpel är mer än 5 minuter gammal.

Exemplet nedan kontrollerar varje signatur i headern, så det fortsätter fungera under en hemlighetsrotation.

```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);
  });
}
```

#### Rotera en signeringshemlighet

Under den 24 timmar långa övergångsperioden efter en rotation innehåller X-DomScan-Signature två signaturer åtskilda av ett kommatecken, med den nya hemligheten först, som visas nedan. Godkänn en begäran när någon av posterna matchar en hemlighet du litar på, driftsätt den nya hemligheten och sluta sedan lita på den gamla. Om du roterar igen under övergångsperioden upphör den äldre tidigare hemligheten att gälla omedelbart.

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

#### Omförsök och automatisk pausning

Returnera valfri 2xx-status inom 8 sekunder för att bekräfta en varning. Omdirigeringar, andra statuskoder och tidsgränser försöks igen med exponentiell backoff (1, 4, 16, 64 och 256 minuter), upp till 6 försök totalt. Efter 15 misslyckade försök i följd pausas endpointen. Aktivera den igen med PATCH eller från inställningarna för Övervakning.

När en endpoint pausas efter upprepade fel får endpointens ägare ett e-postmeddelande med endpointens värd, det senaste felet och en länk till övervakningsinställningarna. Åtgärda endpointen och aktivera den sedan igen i övervakningsinställningarna eller med PATCH där enabled är satt till true. När du aktiverar den nollställs felräknaren.

### Aviseringsprenumerationer för bevakningslista

Prenumerera på de aviseringar du vill ha för ett bevakat objekt. Varje prenumeration bevakar ett värdnamn, en TLD eller en varumärkesdomän, och du väljer vilka av dess händelser du vill ta emot. Händelserna skickas till dina signerade webhook-slutpunkter och till dina aviseringar i appen.

| Typ | Händelser | När den utlöses |
| --- | --- | --- |
| `ssl` | `ssl.expiring`, `ssl.expired`, `ssl.changed` | ssl.expiring när certifikatet som ett värdnamn använder går ut inom ssl_expiring_days (30, 14, 7 eller 1, standard 14), en gång per certifikat och tröskel. ssl.expired en gång per utgånget certifikat. ssl.changed när ett nytt certifikatfingeravtryck ses vid två kontroller i följd; payloaden anger om utfärdaren ändrades. |
| `price` | `price.dropped` | När registrerings- eller förnyelsepriset för en TLD, hos en registrar eller den billigaste, sjunker med minst drop_percent från det högsta priset sedan den senaste aviseringen, eller når target_price eller lägre. Priserna kommer från den dagliga prisögonblicksbilden och varje ögonblicksbild utvärderas en gång. |
| `dns` | `dns.changed` | När en bevakad posttyp (A, AAAA, MX, NS, TXT eller CNAME) för något värdnamn ger samma nya svar vid två bekräftade uppslag i följd. |
| `typosquat` | `typosquat.detected` | När en förväxlingsbar domän för varumärkesdomänen har registrerats nyligen, bekräftat med ett auktoritativt registreringsuppslag. Den första fullständiga genomgången av de förväxlingsbara domänerna sätter utgångsläget och skickar ingen avisering. |
| `brand` | `brand.updated` | När den kvadratiska logotypen, den breda logotypen, färgerna, namnet eller de angivna sociala profilerna för en varumärkesdomän ändras och ändringen ses igen vid nästa kontroll. Välj vilka med attributes (logo, wide_logo, colors, name, socials; alla som standard). Den första kontrollen sätter utgångsläget och ger ingen avisering, och ett attribut som inte kunde kontrolleras förblir oförändrat. |

Endast exakta belägg utlöser en händelse. En misslyckad TLS-handskakning, ett DNS-uppslag som misslyckas eller får timeout, ett saknat pris och ett uppslag som blockeras eller begränsas är okända: de ändrar ingenting och leder aldrig till avisering eller debitering. Den första bekräftade kontrollen av en prenumeration sätter dess utgångsläge.

Kontrollerna körs automatiskt: certifikat var 12:e timme, DNS-poster varje timme (med en bekräftande kontroll 15 minuter efter att en ändring först setts), priser var 2:a timme mot den dagliga ögonblicksbilden och förväxlingsbara domäner i omgångar om 30 med en fullständig genomgång varje dag. Efter en okänd kontroll görs nästa försök tidigare. Varumärkesprenumerationer kontrolleras en gång per dag, med en bekräftande kontroll 90 minuter efter att en ändring först setts.

Att skapa prenumerationer och köra kontroller är gratis. Varje avisering som levereras till en webhook-slutpunkt med svaret 2xx kostar 2 krediter, precis som alla andra övervakningsaviseringar. Misslyckade leveranser återbetalas, och ett konto kan ha upp till 100 prenumerationer, varav 20 för förväxlingsbara domäner.

POST /v1/watchlist/alerts

Skapa en prenumeration. type avgör vilka fält som gäller: domain för ssl, dns och typosquat; tld, registrar, price_type, drop_percent och target_price för price. Fält som inte gäller för typen avvisas.

#### Begärandekropp

| Parameter | Typ | Description |
| --- | --- | --- |
| type | string | ssl, price, dns eller typosquat. Obligatoriskt. |
| domain | string | Värdnamn att bevaka för ssl och dns, eller varumärkesdomänen för typosquat. |
| tld | string | TLD att bevaka för price, till exempel com. |
| registrar | string | Registrar-id för price. Utelämna för att bevaka den billigaste registrarn. |
| events | string[] | Händelser att ta emot. Som standard alla händelser för typen. |
| ssl_expiring_days | integer | Antal dagar före utgång för ssl.expiring: 30, 14, 7 eller 1. Standard 14. |
| price_type | string | registration (standard) eller renewal. |
| drop_percent | number | Avisera vid en sänkning på minst denna procentsats, 1 till 95. |
| target_price | number | Avisera när priset i USD når detta belopp eller lägre. En prisprenumeration kräver drop_percent, target_price eller båda. |
| record_types | string[] | Posttyper att bevaka för dns. Som standard A, AAAA, MX, NS, TXT och CNAME. |
| notify_email | string | Valfritt. Skickar även varje avisering från den här prenumerationen via e-post till den här adressen (3 krediter per skickat e-postmeddelande). Webhook-leveransen ändras inte. Ändra den senare med PATCH, eller skicka null för att stoppa e-postmeddelandena. |

#### Exempelbegäran

```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
  }'
```

#### Exempelsvar

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

#### Svarsfält

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

Lista dina prenumerationer med senaste bekräftade belägg och kontrollstatus, vilka händelser varje typ stöder, kontrollschemat och aviseringspriset.

#### Svarsfält

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

#### Exempelsvar

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

Hämta en prenumeration med senaste bekräftade belägg och de 20 senaste händelserna.

#### Svarsfält

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

#### Exempelsvar

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

Pausa eller återuppta en prenumeration med enabled, eller ändra events, ssl_expiring_days, drop_percent, target_price eller record_types. Ett nytt målpris aviserar bara vid en senare prisförändring.

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

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

#### Svarsfält

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

#### Exempelsvar

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

Ta bort en prenumeration. Händelser som ännu inte skickats tas bort och debiteras aldrig.

#### Svarsfält

| Fält | Typ |
| --- | --- |
| `id` | string |
| `deleted` | boolean |

#### Exempelsvar

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

#### Exempel på en dns.changed-händelse

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