Управление записями через API
Обновлено 10 ноября 2026 · 1 мин чтения · Также на Հայերեն, English
Всё, что вы делаете с записями в панели, можно делать и через API — это удобно для деплоя, CI-пайплайнов и скриптов. Понадобится API-токен, сохранённый в переменной окружения HIMK_TOKEN.
1. Создайте запись
Отправьте POST-запрос к записям зоны:
bash
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": 300}'В теле запроса четыре поля:
type— один из типовA,AAAA,MX,TXT,CNAME.name— имя относительно зоны, напримерwww.content— значение, например IP-адрес или имя хоста.ttl— сколько секунд резолверы могут кешировать запись.
2. Разберите ответ
API возвращает созданную запись:
json
{"id": "rec_8f2k1q", "name": "www.example.am", "type": "A", "ttl": 300}Сохраните id, если скрипту позже понадобится изменить или удалить запись.
3. Запускайте из CI
Храните токен в CI как секретную переменную HIMK_TOKEN, но никогда — в репозитории. Используйте отдельный токен для каждого пайплайна, чтобы его можно было отозвать независимо от других.