Документація 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 днів. |
hold | DNS-відповіді припинено; можна відновити оплатою. |
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
Перевірка доступності
{"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
Реєстрація чи доступність, дати, статус і сервери імен. Дані власника не повертаються. Додайте ?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
Перелік, реєстрація, видалення
[{"name":"petersblog.d.ua","label":"petersblog","status":"active","records":4,"claimed_at":"2026-09-10T09:00:00Z","expires_at":"2027-09-10T09:00:00Z"}]
Тіло: {"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", ...}
Переміщує домен до кошика й прибирає записи з опублікованого DNS. Збережені записи залишаються для відновлення. Підписка картки не скасовується: майбутні продовження потрібно скасувати окремо в оплаті. Оплачені імена зазвичай перебувають у карантині 30 днів, якщо їх не видалено остаточно раніше; дивіться кошик і відновлення.
Ваша пошта, ліміти, поточна звичайна ціна й дозволи токена. Ціну конкретного імені дивіться у відповіді домену чи перевірки доступності.
Перевірка DNS та HTTPS
Перевіряє 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."}
Записи
| Поле | Тип | Примітки |
|---|---|---|
host | string | @ для самого домену (типово), www, *, _acme-challenge, mc.eu (вкладені імена дозволені). |
type | enum | Дивіться типи записів. |
content | string | IP, ім’я хоста, текст або формат відповідного типу нижче. Кінцева крапка не потрібна. |
ttl | int | 60–86400 секунд, типово 300. |
prio | int | Пріоритет 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 із причиною. Додавання власного запису на @ автоматично прибирає запис паркування.
Типи записів
| Тип | Формат вмісту | Приклад |
|---|---|---|
A | IPv4 | 203.0.113.7 |
AAAA | IPv6 | 2001:db8::7 |
CNAME | ім’я хоста; не може співіснувати з іншими записами на тому самому хості | cname.vercel-dns.com |
TXT | текст до 4000 символів (лапки додаються автоматично) | v=spf1 -all |
MX | поштовий хост, пріоритет у prio | mail.protonmail.ch / пріоритет 10 |
SRV | weight port target, пріоритет у prio | 5 25565 petersblog.d.ua |
CAA | flags tag "value" | 0 issue "letsencrypt.org" |
NS | ім’я хоста — делегування піддомену іншому DNS-провайдеру | ns1.example-dns.com |
Готові налаштування
Замінює маршрутні записи лише для відповідних хостів, зберігаючи пошту, TXT та інші записи. За конфлікту повертає 422 без зміни DNS. Делеговані домени спочатку потрібно перевести на керований DNS. Параметри передаються в params.
Спочатку додайте точне ім’я хоста до проєкту на хостингу. Для Vercel, Netlify та Pages необов’язковий параметр params.host обирає @ (типово) або www; змінюється лише цей хост. CNAME не може співіснувати з MX чи TXT на одному хості: оберіть www для збереження пошти на @. Записи підтвердження провайдера мають залишатися в межах зареєстрованого домену.
| Набір налаштувань | Параметри | Створені записи |
|---|---|---|
vercel | target | CNAME на точну адресу з розділу Domains вашого проєкту |
netlify | site | CNAME на повне ім’я вашого сайту, наприклад your-site.netlify.app |
cf-pages | project | CNAME на повне ім’я your-project.pages.dev ; спочатку додайте його в Pages, щоб уникнути помилки 522 |
github-pages | user | 4 × @ A 185.199.108-111.153, www CNAME user.github.io |
cf-tunnel | Недоступно | Повертає 422: Tunnel потребує DNS-записів у тому самому акаунті Cloudflare |
minecraft | ip, port | @ A ip, _minecraft._tcp SRV 5 port name |
server | ip | @ 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-сервери (делегування)
Тіло: {"nameservers": ["ns1.example-dns.com", "ns2.example-dns.com"]} (2–6 хостів, які мають визначатися через DNS і не бути всередині самого домену). Замінює всі записи на NS, щоб petersblog.d.ua та все всередині обслуговувалися провайдером, який приймає саме цю зону, або вашим авторитетним DNS-сервером. Спочатку створіть і перевірте зону petersblog.d.ua там. Делегування NS не гарантує прийняття як окремої зони Cloudflare. Експортуйте записи перед перемиканням: делегування замінює керовані записи.
Повернення до керованого DNS на ns1/ns2/ns3.d.ua (parks the name; add records again).
Імпорт / експорт
Один запис на рядок, 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 днів. Підписка картки не скасовується: зупиніть майбутні продовження в оплаті. Домени з оплатою з балансу не продовжуються в кошику. Жодна з цих дій автоматично не повертає кошти.
Відновлює збережені DNS-записи, якщо домен ще в кошику, оплачений термін не минув і немає інших обмежень реєстрації чи блокування. Домен із простроченим терміном не можна відновити лише тому, що 30 днів ще не минули.
Остаточно видаляє збережені записи після підтвердження скасування підписки картки. Помилки скасування зупиняють операцію. Успішне видалення може звільнити доступне ім’я до завершення карантину; зарезервовані й заблоковані імена залишаються обмеженими. Дію неможливо скасувати. Планове очищення зазвичай намагається остаточно видалити домен через 30 днів у кошику.
Динамічний DNS
Використовує протокол 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 днів після першої оплати реєстрації, якщо домен не використовувався. Ця пропозиція не обмежує законних прав. Дивіться умови повернення. |
| Частота API | 600 запитів за хвилину на токен; 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.