DNS API v1 в Himk теперь доступен всем аккаунтам. Всё, что вы делаете с зонами и записями в панели, теперь можно делать из скрипта, CI-пайплайна или собственных инструментов.
Что можно делать
- Создавать и удалять DNS-зоны.
- Просматривать, добавлять, изменять и удалять записи в зоне.
- Автоматизировать то, что раньше делалось вручную: например, добавлять записи для верификации или направлять новый поддомен на сервер.
API работает по HTTPS и принимает и отдаёт JSON. Базовый адрес — https://api.himk.am/v1.
Создайте токен
Запросы авторизуются API-токеном. Войдите в my.himk.am, создайте токен и скопируйте его: он показывается только один раз. Токенов может быть несколько, например по одному на проект, и любой из них можно отозвать в любой момент.
Храните токен в секрете Токен действует от имени вашего аккаунта. Держите его в переменной окружения или менеджере секретов, но не в репозитории. Если токен утёк, отзовите его в панели и создайте новый.
Первый запрос
Этот запрос добавляет A-запись для www.example.am:
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 чего-то не хватает, напишите нам.