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

API-токены

Обновлено 10 ноября 2026 · 1 мин чтения · Также на Հայերեն, English

API Himk позволяет делать из кода всё то же, что и в панели. Каждый запрос аутентифицируется API-токеном, который передаётся в заголовке Authorization.

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

  1. Откройте в панели Настройки → API-токены.
  2. Нажмите Создать токен и дайте ему имя, по которому понятно, где он используется, например ci-deploy.
  3. Скопируйте токен. Он показывается только один раз.

2. Используйте токен

Сохраните токен в переменной окружения и передавайте его как bearer-токен:

bash
export HIMK_TOKEN="paste-your-token-here"

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}'

3. Храните токены надёжно

  • Обращайтесь с токеном как с паролем: не добавляйте его в репозиторий и не отправляйте в чатах.
  • Создавайте отдельный токен для каждого скрипта или сервиса, чтобы отозвать один, не затрагивая остальные.
  • Если токен утёк, сразу удалите его в панели и создайте новый.

Что дальше