m.MeowMeow Developers
ENOpenAPI ↗
Документация/API reference
API REFERENCE

Изменение настроек

POST/api/v1/domains/{id}/operations

Работает только с данными вашего аккаунта. Передавайте API-ключ в заголовке Authorization. Ответы возвращаются в JSON.

Запрос

В BASE_URL укажите HTTPS-адрес этого сайта, в API_KEY — свой секретный ключ. RESOURCE_ID замените идентификатором из ответа API.

cURL
curl --request POST "${BASE_URL}/api/v1/domains/RESOURCE_ID/operations" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: YOUR_UNIQUE_ACTION_UUID" \
  --data '{"kind": "dns.sync", "payload": {}}'

Заголовки и параметры

Authorizationобязательно

Bearer YOUR_API_KEY

idpath · stringобязательно

Числовой ID домена; UUID для заказа, операции или запроса.

Idempotency-Keyheader · stringобязательно

Уникальный ключ действия. При повторе используйте то же значение и тот же JSON.

JSON body

Выберите одно действие. У каждого варианта свои параметры. Постановка в очередь ещё не означает, что провайдер применил изменение.

dns.add
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "dns.add"

payloadobjectобязательно

Параметры выбранного действия.

payload.record_typestringобязательно

Тип DNS-записи: например A, AAAA, CNAME, TXT, MX или SRV.

payload.namestringобязательно

@ — корень, * — wildcard, либо имя записи.

payload.contentstringобязательно

Значение записи, соответствующее её типу.

payload.ttlinteger

Время кэширования DNS в секундах; 1 — автоматическое.

payload.priorityinteger

Приоритет MX: меньшее значение предпочтительнее.

payload.proxiedboolean

Проксировать совместимую запись через Cloudflare.

payload.commentstring

Служебная заметка к записи; не публикуется в DNS.

dns.update
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "dns.update"

payloadobjectобязательно

Параметры выбранного действия.

payload.record_idintegerобязательно

ID записи из GET /domains/{id}/dns.

payload.record_typestringобязательно

Тип DNS-записи: например A, AAAA, CNAME, TXT, MX или SRV.

payload.namestringобязательно

@ — корень, * — wildcard, либо имя записи.

payload.contentstringобязательно

Значение записи, соответствующее её типу.

payload.ttlinteger

Время кэширования DNS в секундах; 1 — автоматическое.

payload.priorityinteger

Приоритет MX: меньшее значение предпочтительнее.

payload.proxiedboolean

Проксировать совместимую запись через Cloudflare.

payload.commentstring

Служебная заметка к записи; не публикуется в DNS.

dns.delete
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "dns.delete"

payloadobjectобязательно

Параметры выбранного действия.

payload.record_idintegerобязательно

ID записи из GET /domains/{id}/dns.

dns.sync
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "dns.sync"

payloadobjectобязательно

Параметры выбранного действия.

dns.rrset
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "dns.rrset"

payloadobjectобязательно

Параметры выбранного действия.

payload.record_typestringобязательно

Тип DNS-записи: например A, AAAA, CNAME, TXT, MX или SRV.

payload.namestringобязательно

@ — корень, * — wildcard, либо имя записи.

payload.valuesarrayобязательно

Полный новый набор значений данного имени и типа. Пустой массив удаляет набор.

maxItems: 50

payload.values[].contentstringобязательно

Значение записи, соответствующее её типу.

payload.values[].ttlinteger

Время кэширования DNS в секундах; 1 — автоматическое.

payload.values[].priorityinteger

Приоритет MX: меньшее значение предпочтительнее.

payload.values[].proxiedboolean

Проксировать совместимую запись через Cloudflare.

payload.values[].commentstring

Служебная заметка к записи; не публикуется в DNS.

payload.expectedstringобязательно

Подпись текущего RRset из GET DNS. Защищает от перезаписи чужих изменений.

ns.set
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "ns.set"

payloadobjectобязательно

Параметры выбранного действия.

payload.nameserversarrayобязательно

Имена серверов DNS, не IP-адреса.

minItems: 2 · maxItems: 20

native.configure
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "native.configure"

payloadobjectобязательно

Параметры выбранного действия.

cloudflare.connect
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "cloudflare.connect"

payloadobjectобязательно

Параметры выбранного действия.

payload.ipstring

Публичный IPv4-адрес вашего сервера.

cloudflare.setting
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "cloudflare.setting"

payloadobjectобязательно

Параметры выбранного действия.

payload.settingstringобязательно

Имя настройки из cloudflare.available_settings в карточке домена.

payload.valueobjectобязательно

Допустимое значение выбранной настройки из available_settings.

payload.countriesarray

Только для GEO: список кодов стран ISO 3166-1 alpha-2, например ["US", "DE"]. Без поля используется сохранённый список домена.

maxItems: 249

cloudflare.proxy
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "cloudflare.proxy"

payloadobjectобязательно

Параметры выбранного действия.

payload.enabledbooleanобязательно

Включить или отключить выбранную функцию.

cloudflare.purge
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "cloudflare.purge"

payloadobjectобязательно

Параметры выбранного действия.

glue.save
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "glue.save"

payloadobjectобязательно

Параметры выбранного действия.

payload.namestringобязательно

@ — корень, * — wildcard, либо имя записи.

payload.ipstring

Публичный IPv4-адрес вашего сервера.

payload.ip6string

Публичный IPv6-адрес вашего сервера.

glue.delete
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "glue.delete"

payloadobjectобязательно

Параметры выбранного действия.

payload.namestringобязательно

@ — корень, * — wildcard, либо имя записи.

glue.sync
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "glue.sync"

payloadobjectобязательно

Параметры выбранного действия.

redirect.save
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "redirect.save"

payloadobjectобязательно

Параметры выбранного действия.

payload.slugstringобязательно

Имя перенаправления; используется для создания или обновления.

payload.targetstringобязательно

Целевой HTTP(S)-адрес перенаправления.

payload.status_codeinteger

HTTP-код: 301/308 — постоянный, 302/307 — временный. 307/308 сохраняют HTTP-метод.

payload.preserve_queryboolean

Сохранять параметры запроса в целевом адресе.

payload.enabledboolean

Включить или отключить выбранную функцию.

payload.source_patternstring

Шаблон исходного URL для перенаправления.

redirect.delete
kindstringобязательно

Тип действия; выбирайте нужный вариант ниже.

const: "redirect.delete"

payloadobjectобязательно

Параметры выбранного действия.

payload.redirect_idintegerобязательно

ID из GET /domains/{id}/redirects.

Ответ

202 означает «принято», а не «выполнено». Проверяйте состояние заказа или операции. При неизвестном результате не создавайте повторную покупку. Суммы — десятичные строки в USD, даты — ISO 8601.
request_idstringобязательно

Идентификатор для восстановления результата после сетевого сбоя.

idstringобязательно
domain_idinteger
kindstring

Тип действия; выбирайте нужный вариант ниже.

statusstringобязательно

Текущее состояние. Принятое задание ещё не означает успех.

created_atstring | null
needs_reviewbooleanобязательно

Неизвестный результат требует сверки, а не повторной операции.

messagestring | null
Пример структуры ответа · условные значения
JSON
{
  "request_id": "00000000-0000-4000-8000-000000000001",
  "id": "00000000-0000-4000-8000-000000000001",
  "domain_id": 1,
  "kind": "string",
  "status": "string",
  "created_at": "2026-10-02T12:00:00Z",
  "needs_review": false,
  "message": "string"
}

Ошибки и статусы

error.code · error.message · request_id

401

Ключ неверен или отозван.

404

Ресурс не найден в вашем аккаунте.

409

Конфликт ключа повтора или запрос ещё выполняется.

422

Неверные параметры или условия операции, включая баланс.

500

Результат может быть неизвестен. Проверьте запрос.

503

Временно недоступно. Учитывайте Retry-After.