API доменов

Последнее обновление: 8 сентября 2026

Все запросы требуют заголовок Authorization: Bearer <token>, см. Аутентификация. Каждый запрос действует только в рамках доменов вашей организации.

GET/v1/domainsСписок доменов текущей организации

POST/v1/domainsСоздать домен — body: { "url": "https://example.com" }

GET/v1/domains/:idДанные одного домена (включая verifyToken, apiKey, bannerConfig)

POST/v1/domains/:id/verifyПроверить владение доменом по .well-known/cookiebot.txt

PATCH/v1/domains/:id/banner-configОбновить конфигурацию баннера (частично, любые поля)

DELETE/v1/domains/:idУдалить домен

Создание домена

curl -X POST https://api.cookiestack.dev/v1/domains \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.ru"}'

URL должен указывать на публичный, реально существующий хост — локальные и приватные адреса отклоняются. Число доменов ограничено тарифом организации; при превышении лимита сервер вернёт ошибку.

banner-config

Принимает частичный объект — присылайте только те поля, которые нужно изменить. Полный список полей — в гайде по настройке баннера.