D.UA

Документація API

Керуйте доменами й DNS через описаний нижче REST API. Безпека акаунта та частина платіжних дій доступні в кабінеті. API використовує bearer-токени й відповіді JSON.

Base URL     https://api.d.ua/v1
Auth         Authorization: Bearer <token>
Spec         https://api.d.ua/v1/openapi.json
DDNS         https://ddns.d.ua/nic/update
MCP          https://mcp.d.ua/

Огляд

У d.ua домен — це ім’я третього рівня, наприклад petersblog.d.ua. Його зона обслуговується нашим авторитетним DNS: PowerDNS на трьох серверах ns1.uk.app, ns2.uk.app і ns3.uk.app. Ви керуєте записами в межах домену з урахуванням лімітів і перевірок: www, api, *, _acme-challengeта іншими. Зміни публікуються за кілька секунд; кеш резолверів діє відповідно до TTL (типово 300 с).

Домен проходить такі стани:

СтатусЗначення
pendingЗарезервовано на 48 годин, ще не оплачено. У DNS відсутній.
parkedОплачено, власних записів ще немає — показується сторінка паркування.
activeОплачено та спрямовано на сервер.
graceПродовження не оплачене; працює ще 30 днів.
holdDNS-відповіді припинено; можна відновити оплатою.
suspendedЗаблоковано через порушення. Показується сторінка блокування.

Автентифікація

Створюйте токени на my.d.ua/tokens. Кожен токен має дозволи; запит без потрібного дозволу отримує 403.

ДозвілМожливості
readПерелік доменів і записів, перевірка, WHOIS та інформація акаунта.
write:recordsДодавання, зміна й видалення записів; застосування готових налаштувань. Адаптери ACME використовують цей дозвіл, а dyndns2 — окремий DDNS-токен домену.
write:namesРеєстрація (зокрема з оплатою з балансу), видалення, відновлення й остаточне видалення доменів.

Токени показуються лише раз. Відкликання діє негайно. Не зберігайте токени в Git; для CI використовуйте лише дозвіл write:records .

Формати й помилки

  • Домени можна передавати як petersblog або petersblog.d.ua; обидва формати підтримуються всюди.
  • Тіло запиту: JSON (Content-Type: application/json) або дані форми. Відповіді — JSON, якщо не зазначено інше.
  • Помилки перевірки повертають 422 із {"message": "...", "errors": {"field": ["..."]}}.
  • Ліміт: 600 запитів за хвилину на токен. Заголовки X-RateLimit-Remaining та Retry-After показують залишок і час повторної спроби.
  • Дата й час — ISO 8601, UTC.
КодУмова
401Токен відсутній або недійсний.
402Бракує коштів для явно запитаної оплати з балансу; відповідь містить посилання для оплати.
403Токен не має потрібного дозволу.
404Домен або запис не знайдено чи він належить іншому користувачу.
422Недійсні дані, домен недоступний, ліміт вичерпано або домен ще не активований.
429Перевищено частоту запитів.

Швидкий старт

export TOKEN=ukapp_...

# 1. check availability and the quoted annual price
curl "https://api.d.ua/v1/names/check?name=petersblog"
# {"name":"petersblog.d.ua","available":true,"price":199,"currency":"UAH","billing":"yearly, auto-renew"}

# 2. reserve it (returns a checkout URL; the name activates after payment)
curl -H "Authorization: Bearer $TOKEN" -X POST https://api.d.ua/v1/names -d name=petersblog -d pay=checkout

# 3. once active, point it at your server
curl -H "Authorization: Bearer $TOKEN" -X POST https://api.d.ua/v1/names/petersblog/records \
     -d host=@ -d type=A -d content=203.0.113.7

# 4. or use a preset
curl -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -X POST https://api.d.ua/v1/names/petersblog/presets/vercel \
     -d '{"params":{"target":"YOUR-PROJECT.vercel-dns-017.com"}}'

# 5. confirm DNS + HTTPS
curl -H "Authorization: Bearer $TOKEN" -X POST https://api.d.ua/v1/names/petersblog/verify

Перевірка доступності

GET /v1/names/check?name=ім’я публічний
{"name":"petersblog.d.ua","available":true,"reason":null,"price":199,"currency":"UAH","billing":"yearly, auto-renew"}
{"name":"paypal-login.d.ua","available":false,"reason":"Names containing protected brands need manual review. Contact support@d.ua."}

Звичайні імена містять 3–63 символи, a-z 0-9 -, без дефіса на початку чи в кінці. Вибрані короткі імена можуть бути відкриті для преміум-реєстрації; інші короткі імена зарезервовані. Punycode, системні й заблоковані імена недоступні. Пошук повертає актуальну доступність, річну ціну та обмеження. Преміум-пропозиція не надає прав на торговельну марку.

WHOIS

GET /v1/whois/ім’я публічний · JSON або текст

Реєстрація чи доступність, дати, статус і сервери імен. Дані власника не повертаються. Додайте ?format=json або передайте Accept: application/json; інакше отримаєте звичайний текст WHOIS, зручний для curl.

$ curl https://name.d.ua/whois/petersblog
Domain Name: petersblog.d.ua
Registry: d.ua (third-level registry, powered by PowerDNS)
Status: available
Price: 199,00 грн/year, renews automatically
Register: https://my.d.ua/dashboard?claim=petersblog
Name Servers: ns1.uk.app, ns2.uk.app, ns3.uk.app
DNSSEC: unsigned

Перелік, реєстрація, видалення

GET /v1/names read
[{"name":"petersblog.d.ua","label":"petersblog","status":"active","records":4,"claimed_at":"2026-09-10T09:00:00Z","expires_at":"2027-09-10T09:00:00Z"}]
POST /v1/names write:names

Тіло: {"name": "petersblog", "pay": "checkout"}. Явний параметр pay=checkout резервує ім’я на 48 годин і повертає 201 із checkout_url; активація відбувається після підтвердження оплати. Використовуйте ціну з перевірки доступності, зокрема преміум-ціну.

Із pay=balanceAPI списує кошти з доступного балансу й активує домен. Якщо pay не задано, за достатнього балансу річна оплата списується з нього; інакше повертається посилання для оплати. Явний запит оплати з недостатнього балансу повертає 402 і платіжні посилання. Дозвольте автоматичне списання перед використанням цього маршруту без pay=checkout. Резервування через MCP повертає посилання для оплати й не витрачає баланс.

{"name":"petersblog.d.ua","status":"pending","checkout_url":"https://my.d.ua/names/42/checkout", ...}
GET /v1/names/ім’я read
DELETE /v1/names/ім’я write:names

Переміщує домен до кошика й прибирає записи з опублікованого DNS. Збережені записи залишаються для відновлення. Підписка картки не скасовується: майбутні продовження потрібно скасувати окремо в оплаті. Оплачені імена зазвичай перебувають у карантині 30 днів, якщо їх не видалено остаточно раніше; дивіться кошик і відновлення.

GET /v1/me read

Ваша пошта, ліміти, поточна звичайна ціна й дозволи токена. Ціну конкретного імені дивіться у відповіді домену чи перевірки доступності.

Перевірка DNS та HTTPS

POST /v1/names/ім’я/verify read

Перевіряє DNS та одну отриману публічну адресу на HTTPS і чинний сертифікат для домену. HTTP-статус показується окремо; перенаправлення не виконуються. Результат може використовуватися повторно протягом хвилини. Це не перевірка всіх адрес, функцій застосунку чи ігрового сервера.

{"name":"petersblog.d.ua",
 "dns":[{"host":"petersblog.d.ua","type":"A","ip":"76.76.21.21","ttl":300}],
 "https":{"ok":true,"issuer":"Let's Encrypt","expires":"2026-12-09T08:33:00+00:00"},
 "hsts_preloaded":true,"note":"Live."}

Записи

GET /v1/names/ім’я/records read
POST /v1/names/ім’я/records write:records
PUT /v1/names/ім’я/records/id write:records
DELETE /v1/names/ім’я/records/id write:records
ПолеТипПримітки
hoststring@ для самого домену (типово), www, *, _acme-challenge, mc.eu (вкладені імена дозволені).
typeenumДивіться типи записів.
contentstringIP, ім’я хоста, текст або формат відповідного типу нижче. Кінцева крапка не потрібна.
ttlint60–86400 секунд, типово 300.
priointПріоритет MX і SRV, типово 0.
curl -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
     -X POST https://api.d.ua/v1/names/petersblog/records \
     -d '{"host":"_minecraft._tcp","type":"SRV","content":"5 25565 petersblog.d.ua","prio":0}'
# 201 {"id":91,"host":"_minecraft._tcp","type":"SRV","content":"5 25565 petersblog.d.ua","ttl":300,"prio":0,"source":"api"}

Кожен запис виконується в транзакції: якщо DNS-сервер відхиляє запис, нічого не зберігається, а ви отримуєте 422 із причиною. Додавання власного запису на @ автоматично прибирає запис паркування.

Типи записів

ТипФормат вмістуПриклад
AIPv4203.0.113.7
AAAAIPv62001:db8::7
CNAMEім’я хоста; не може співіснувати з іншими записами на тому самому хостіcname.vercel-dns.com
TXTтекст до 4000 символів (лапки додаються автоматично)v=spf1 -all
MXпоштовий хост, пріоритет у priomail.protonmail.ch / пріоритет 10
SRVweight port target, пріоритет у prio5 25565 petersblog.d.ua
CAAflags tag "value"0 issue "letsencrypt.org"
NSім’я хоста — делегування піддомену іншому DNS-провайдеруns1.example-dns.com

Готові налаштування

POST /v1/names/ім’я/presets/набір write:records

Замінює маршрутні записи лише для відповідних хостів, зберігаючи пошту, TXT та інші записи. За конфлікту повертає 422 без зміни DNS. Делеговані домени спочатку потрібно перевести на керований DNS. Параметри передаються в params.

Спочатку додайте точне ім’я хоста до проєкту на хостингу. Для Vercel, Netlify та Pages необов’язковий параметр params.host обирає @ (типово) або www; змінюється лише цей хост. CNAME не може співіснувати з MX чи TXT на одному хості: оберіть www для збереження пошти на @. Записи підтвердження провайдера мають залишатися в межах зареєстрованого домену.

Набір налаштуваньПараметриСтворені записи
verceltargetCNAME на точну адресу з розділу Domains вашого проєкту
netlifysiteCNAME на повне ім’я вашого сайту, наприклад your-site.netlify.app
cf-pagesprojectCNAME на повне ім’я your-project.pages.dev ; спочатку додайте його в Pages, щоб уникнути помилки 522
github-pagesuser4 × @ A 185.199.108-111.153, www CNAME user.github.io
cf-tunnelНедоступноПовертає 422: Tunnel потребує DNS-записів у тому самому акаунті Cloudflare
minecraftip, port@ A ip, _minecraft._tcp SRV 5 port name
serverip@ A ip, www CNAME name
parking—повернення на нашу сторінку паркування
curl -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
     -X POST https://api.d.ua/v1/names/petersblog/presets/minecraft \
     -d '{"params":{"ip":"203.0.113.7","port":"25565"}}'

Власні NS-сервери (делегування)

PUT /v1/names/ім’я/nameservers write:records

Тіло: {"nameservers": ["ns1.example-dns.com", "ns2.example-dns.com"]} (2–6 хостів, які мають визначатися через DNS і не бути всередині самого домену). Замінює всі записи на NS, щоб petersblog.d.ua та все всередині обслуговувалися провайдером, який приймає саме цю зону, або вашим авторитетним DNS-сервером. Спочатку створіть і перевірте зону petersblog.d.ua там. Делегування NS не гарантує прийняття як окремої зони Cloudflare. Експортуйте записи перед перемиканням: делегування замінює керовані записи.

DELETE /v1/names/ім’я/nameservers write:records

Повернення до керованого DNS на ns1/ns2/ns3.d.ua (parks the name; add records again).

Імпорт / експорт

GET /v1/names/ім’я/export read · text/plain
POST /v1/names/ім’я/import write:records

Один запис на рядок, host type content [ttl] [prio]; рядки, що починаються з ; або # , ігноруються. Передавайте в полі zone або в сирому тілі запиту. Імпорт додає записи, тому експорт → редагування → видалення → імпорт дає повну заміну.

curl -H "Authorization: Bearer $TOKEN" https://api.d.ua/v1/names/petersblog/export
; petersblog.d.ua — exported 2026-09-10T10:00:00Z
; host type content ttl [prio]
@ A 203.0.113.7 300
www CNAME petersblog.d.ua 300
@ MX mail.example.com 3600 10
@ TXT "v=spf1 -all" 300

Кошик (видалені домени)

DELETE /v1/names/{label} переміщує домен до кошика й прибирає опубліковані DNS-записи; кешовані відповіді можуть залишатися до завершення TTL. Записи зазвичай зберігаються 30 днів. Підписка картки не скасовується: зупиніть майбутні продовження в оплаті. Домени з оплатою з балансу не продовжуються в кошику. Жодна з цих дій автоматично не повертає кошти.

GET /v1/bin read
POST /v1/bin/ім’я/restore write:names

Відновлює збережені DNS-записи, якщо домен ще в кошику, оплачений термін не минув і немає інших обмежень реєстрації чи блокування. Домен із простроченим терміном не можна відновити лише тому, що 30 днів ще не минули.

DELETE /v1/bin/ім’я write:names

Остаточно видаляє збережені записи після підтвердження скасування підписки картки. Помилки скасування зупиняють операцію. Успішне видалення може звільнити доступне ім’я до завершення карантину; зарезервовані й заблоковані імена залишаються обмеженими. Дію неможливо скасувати. Планове очищення зазвичай намагається остаточно видалити домен через 30 днів у кошику.

Динамічний DNS

GET https://ddns.d.ua/nic/update?hostname=host&myip=ip Базова автентифікація

Використовує протокол dyndns2 . Налаштуйте клієнт із підтримкою власного HTTPS-сервера оновлення, наприклад ddclient. Сумісність роутера чи NAS залежить від моделі та прошивки; самої наявності меню DDNS недостатньо. Ім’я користувача — домен (petersblog.d.ua), пароль — DDNS-токен зі сторінки домену → Динамічний DNS (лише для цього домену). Створіть або замініть його там; скопіюйте одразу, оскільки він показується лише раз. Відкличте токен, щоб зупинити оновлення без видалення DNS-записів. DDNS потребує керованого DNS і активного, припаркованого домену або домену в пільговому періоді. Не передавайте myip для використання адреси запитувача; IPv6 створює AAAA-записи. Відповіді: good ip, nochg ip, badauth, nohost.

# /etc/ddclient.conf
protocol=dyndns2
ssl=yes
use=web
server=ddns.d.ua
login=petersblog.d.ua
password=YOUR_DDNS_TOKEN
home.petersblog.d.ua

# or from cron
curl -u "petersblog.d.ua:YOUR_DDNS_TOKEN" "https://ddns.d.ua/nic/update?hostname=home.petersblog.d.ua"

ACME DNS-01 (wildcard-сертифікати)

Використовуйте адаптери з інструкції налаштування ACME із write:records токеном. Вони створюють TXT-записи перевірки й видаляють лише власні записи, зберігаючи сторонні та паралельні перевірки. Підтримка API не означає наявності вбудованого провайдера d.ua в клієнті сертифікатів. Дотримуйтеся інструкцій установлення й продовження для конкретного клієнта.

Власний хук acme.sh, адаптер lego exec і Python CLI доступні в архіві інтеграцій. Тестову видачу DNS-01 для початкової інтеграції uk.app перевірено з acme.sh 3.1.5 і lego 5.4.1 13 вересня 2026 року. Для d.ua виконайте власну тестову перевірку за інструкції налаштування ACME. Ці інтеграції постачаються тут; вбудований провайдер d.ua не включений до основних проєктів клієнтів. Обмеження центрів сертифікації та групування доменів залишаються чинними; перевірте правила перед масовою видачею.

MCP для ШІ-агентів

Підключіть клієнт Streamable HTTP до https://mcp.d.ua/. Виявлення OAuth спрямовує на вхід d.ua та окремий екран дозволу; потрібен PKCE S256. Клієнти з API-токенами можуть передавати Authorization: Bearer <token> . Дозволи токена залишаються чинними.

Інструмент registry приймає параметр action: check_name, list_names, get_balance, list_records, verify_domain, reserve_name, add_record або delete_record. Додайте name , крім list_names/get_balance. Запис DNS використовує ті самі поля host/type/content/ttl/prio, що й API; для видалення потрібен ID запису.

Дозвіл OAuth відкриває читання акаунта, зміни DNS та резервування. Резервування повертає посилання для оплати людиною; жодна дія MCP не списує кошти з картки чи балансу. Відкличте доступ OAuth у Підключення MCP. Підтримуються HTTPS-зворотні адреси на claude.ai або chatgpt.com та локальні loopback-адреси; інші клієнти потребують явного налаштування callback. Архів інтеграцій також містить локальний адаптер stdio.

Оплата з балансу

Поповнення балансу й оплата домену — окремі транзакції. Маршрут реєстрації REST може автоматично списати достатній баланс, якщо не передано pay=checkout ; резервування MCP цього не робить. Для активних доменів із балансом виконується спроба річного продовження, зокрема повторні спроби в пільговому періоді. Карткові підписки продовжуються через Stripe. Перегляньте умови оплати й скасування та платіжний кабінет перед фінансуванням автоматизованих операцій.

Обмеження й оплата

ЦінаЗвичайний тариф: 199,00 грн/рік. Базовий преміум-тариф нової реєстрації: 1 490,00 грн/рік. Чинні преміум-реєстрації зберігають погоджену річну ціну. Перевірте ціну конкретного імені та підсумок оплати; дивіться тарифи.
Доменів на акаунт100 (для збільшення ліміту напишіть на support@d.ua).
Записів на домен100.
Резервування48 годин без оплати, після чого ім’я підлягає звільненню.
Завершення термінуЗазвичай: 30 днів пільгового періоду → 30 днів утримання без DNS → кошик із 30-денним карантином. Планові завдання, раннє остаточне видалення та обмеження реєстрації впливають на повторну доступність; дивіться умовами користування.
Повернення коштівЗапит протягом 14 днів після першої оплати реєстрації, якщо домен не використовувався. Ця пропозиція не обмежує законних прав. Дивіться умови повернення.
Частота API600 запитів за хвилину на токен; DDNS — 60 за хвилину на домен.

HTTPS

Налаштуйте HTTPS на хостингу чи своєму сервері. ACME DNS-01 підтверджує домен через DNS; HTTP-01 потребує публічного доступу до порту 80. Сам DNS-запис не видає сертифікат. Перевірте ліміти центру сертифікації та скористайтеся перевіркою для діагностики домену.

OpenAPI

Машинозчитувана специфікація доступна за адресою https://api.d.ua/v1/openapi.json (OpenAPI 3.1). Згенеруйте клієнт через openapi-generatorабо вставте URL у Postman, Insomnia чи Bruno.