API и MCP
Ключи API — какой ключ под какую задачу
Готовые наборы прав под типовые задачи — отчёты, сертификаты, DNS, ИИ-агент, покупки — и правила, по которым человек или ассистент ИИ подбирает ключ.
Эта страница — для вас и для ассистента ИИ, который помогает настроить ключ. Найдите свою задачу в таблице, выберите в форме «Новый ключ» указанный шаблон и заполните «Где действует» и «Условия», как написано. Как работает сама форма — в ключах API.
Задача → ключ
| Задача | Шаблон в форме | Права | Где действует | Условия |
|---|---|---|---|---|
| Скрипт или дашборд читает домены и сроки | «Только чтение» | domain.read, monitor.read | все домены | IP — по желанию, срок до 365 дней |
| Бухгалтерия или отчёт видит баланс | «Баланс и домены» | domain.read, billing.read | все домены | IP — по желанию, срок до 365 дней |
| Программа ставит домены на мониторинг | «Мониторинг» | monitor.read, monitor.edit | все домены или выбранные | IP сервера, 90 дней |
| Сервер сам обновляет файлы сертификата | «Сертификаты SSL» | ssl.read, ssl.reissue | только домены этого сервера | IP сервера, 90 дней |
| Программа заказывает сертификаты | «SSL — заказ» | ssl.read, ssl.reissue, ssl.order, billing.read | выбранные домены или все | IP обязательно, дневной лимит (для всех доменов — обязательно), 30 дней |
| Менеджер или подрядчик правят записи нескольких сайтов | «Зоны DNS — для менеджера» | dns.read, dns.edit | только выбранные домены | личный ключ, 90 дней |
| ИИ-агент или автоматизация ведут все зоны | «Зоны DNS — полный доступ» | dns.read, dns.edit, dns.zone_create, keys.zones_grant | все домены | ключ организации, IP сервера, 90 дней |
| Продление по расписанию | «Продление доменов» | domain.read, domain.renew, billing.read | все домены или выбранные | IP обязательно, дневной лимит, 30 дней |
| Регистрация новых доменов | «Регистрация доменов» | domain.read, domain.register, billing.read | все домены | IP обязательно, дневной лимит, 30 дней |
| Агент ведёт домен от покупки до записей DNS | «Домены и DNS — для ИИ» | регистрация, продление, все права DNS, кроме выдачи зон, и баланс | все домены | IP обязательно, дневной лимит, 30 дней |
Шаблон лишь заполняет права. Их можно убрать или добавить строкой в форме «Что разрешить ключу».
«Зоны DNS — полный доступ» регистрировать домены не позволяет. Новую зону этот ключ создаёт для домена, который уже есть в организации, или для чужого имени, которое вы переведёте на наши серверы имён. Для домена, которого ещё нет, сначала нужна регистрация.
Один ключ или два
Агенту, который и покупает домены, и ведёт DNS, лучше дать два ключа:
- Ключ DNS — «Зоны DNS — полный доступ», срок 90 дней и больше.
- Ключ на покупки — «Регистрация доменов» или «Продление доменов», срок 30 дней, дневной лимит на 1–2 домена.
Если ключ на покупки утечёт, потеря ограничена дневным лимитом, а короткий ключ скоро выключится сам. Ключ DNS при этом баланса не коснётся. Шаблон «Домены и DNS — для ИИ» проще, но живёт не дольше 90 дней, и при утечке под ударом и записи, и деньги.
Как подбирать ключ — правила для человека и ассистента ИИ
Сначала задача, потом права. Что программа будет делать, с какими доменами, с какого сервера. Права — наименьшие, что закрывают задачу: уровень «Чтение», если изменения не нужны.
Деньги — отдельным ключом. Права
ssl.order,domain.renewиdomain.registerтребуют разрешённых IP, срок такого ключа — не больше 90 дней. Дневной лимит обязателен для продления и регистрации и для любого ключа с деньгами на все домены; ставьте его всегда. Ключ для регистрации возьмёт владельцем только запись «Контактов» с полным адресом и отметкой полномочий: заведите её до выпуска ключа, а форма ключа предупредит, если такой записи ещё нет.Чей ключ. Для сервера, CI или интеграции — «Организации»: он переживёт смену людей. Для себя или своего ассистента на своём компьютере — «Личный».
Разрешённые IP — адрес, откуда идут вызовы. Для сервера — адрес сервера. Для ассистента на вашем компьютере — адрес компьютера: форма показывает его под полем и добавляет кнопкой «Добавить». Домашний адрес может меняться — тогда ключ перестанет работать, и адрес нужно обновить.
Домены — выбранные, когда можно. Менеджеру и серверу сертификата хватит своих доменов. На все домены действуют только новые зоны, выдача зон другим ключам и регистрация новых имён.
Несколько организаций. Личный ключ — «Эта и выбранные»; на «Все мои организации» — только права чтения. Ключ, который тратит деньги, и ключ организации действуют в одной организации.
Срок — короткий. Ключ, который 90 дней никто не вызывал, выключается сам. Задача закончилась — отзовите ключ.
Ключ — только в секреты. Не в чат, не в код страниц, не в репозиторий. Ассистенту ИИ — через переменную окружения или файл секретов, не текстом сообщения.
Проверка. После выпуска:
curl -H "Authorization: Bearer zr_live_..." https://api.zrazu.com/v1/api-keys/currentОтвет покажет права, домены, IP и срок. Если чего-то не хватает — выпустите новый ключ с нужными правами; изменить права существующего ключа нельзя.
Чего не даст ни один ключ
Менять контакты и замки, получать код переноса, отзывать сертификаты, управлять людьми, ключами и оплатой. Эти действия есть только в кабинете. Ассистенту не стоит советовать искать для этого права — их нет.