Документация

Управление записями через 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, но никогда — в репозитории. Используйте отдельный токен для каждого пайплайна, чтобы его можно было отозвать независимо от других.

Что дальше