← Блог

DNS API v1 открыт для всех

Теперь любой аккаунт может создавать API-токены и управлять зонами и записями по HTTPS.

[Имя автора]1 мин чтения

DNS API v1 в Himk теперь доступен всем аккаунтам. Всё, что вы делаете с зонами и записями в панели, теперь можно делать из скрипта, CI-пайплайна или собственных инструментов.

Что можно делать

  • Создавать и удалять DNS-зоны.
  • Просматривать, добавлять, изменять и удалять записи в зоне.
  • Автоматизировать то, что раньше делалось вручную: например, добавлять записи для верификации или направлять новый поддомен на сервер.

API работает по HTTPS и принимает и отдаёт JSON. Базовый адрес — https://api.himk.am/v1.

Создайте токен

Запросы авторизуются API-токеном. Войдите в my.himk.am, создайте токен и скопируйте его: он показывается только один раз. Токенов может быть несколько, например по одному на проект, и любой из них можно отозвать в любой момент.

Храните токен в секрете Токен действует от имени вашего аккаунта. Держите его в переменной окружения или менеджере секретов, но не в репозитории. Если токен утёк, отзовите его в панели и создайте новый.

Первый запрос

Этот запрос добавляет A-запись для www.example.am:

bash
export HIMK_TOKEN="your-token"

curl -X POST https://api.himk.am/v1/zones/example.am/records \
  -H "Authorization: Bearer $HIMK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type": "A", "name": "www", "content": "203.0.113.10", "ttl": 3600}'

Запись начинает отдаваться с ns1.himk.am и ns2.himk.am так же, как запись, созданная в панели.

Что дальше

Начните с руководства по API-токенам, а все эндпоинты и поля найдёте в справочнике DNS API. Если в API чего-то не хватает, напишите нам.

Попробуйте HimkНовые аккаунты получают X XXX ֏ на счёт кошелька.
Зарегистрироваться

Похожие статьи