#Сервисы
Сайту иногда нужны чужие службы: отправить уведомление в Telegram, принять оплату, разложить новую статью по площадкам. Реквизиты этих служб живут в одном разделе панели.
Настройки → Настройки API.
#Что можно подключить
| Сервис | Зачем | Страница |
|---|---|---|
| Уведомления о заявках | заявки с форм падают в рабочий чат | подробно |
| Приём оплаты | эквайринг Т-Банка для магазина | подробно |
| Telegram-канал | анонс новой записи в публичный канал | подробно |
| ВКонтакте | запись на стену сообщества | подробно |
| Telegraph | полный текст мгновенной загрузкой | подробно |
| vc.ru | запись на подсайт | подробно |
| Нейросеть | тексты для автопубликации | подробно |
Ни один из них не обязателен. Сайт работает и без всех сразу: заявки сохраняются в справочник, записи публикуются на самом сайте.
«Настройки API» и «Ключи API» — разные вещи, и стоят рядом в меню.
В «Настройках API» лежат реквизиты чужих служб, которыми пользуется ваш сайт. В «Ключах API» — ключи, по которым в ваш сайт приходят снаружи. Направление обратное. Отдать не тот ключ не тому — самая дорогая ошибка в этих двух разделах.
#Как хранятся ключи
Поле-ключ никогда не показывается целиком. В форме вместо него — маска: короткое значение точками, длинное — первые и последние четыре знака.
sk-a…f3d9
••••••••Под каждым полем-ключом написано, что сохранено, и стоит галочка «очистить».
Пустое поле-ключ при сохранении означает «оставить как было», а не «стереть».
Иначе любое сохранение формы — например, чтобы поставить одну галочку — молча обнуляло бы все ключи разом. Поэтому стирание вынесено в отдельную галочку: чтобы убрать ключ, её надо поставить осознанно.
«Очистить» убирает значение, заданное в панели, а не то, что прописано
в config.secret.php при установке сайта.
Настройки панели перекрывают файл на диске — но только заполненные. Убрали значение в панели — начнёт действовать то, что в файле.
Наружу ключи не отдаются нигде: ни в разметке страницы, ни в ответе проверки, ни в журнале.
#Проверить, что сервис отвечает
У каждого сервиса — кнопка «Проверить связь». Она делает самый дешёвый запрос, на какой способна служба, и отвечает одной строкой.
| Сервис | Что именно проверяется |
|---|---|
| Нейросеть | ключ рабочий и модель с таким именем есть |
| Уведомления о заявках | бот жив, чат ему доступен |
| Telegram-канал | то же, но для канала |
| ВКонтакте | ключ сообщества принят |
| Telegraph | аккаунт отвечает, показывает имя автора |
| Приём оплаты | терминал отвечает, подпись принята |
| vc.ru | не проверяется — у площадки нет метода «кто я» |
Проверка ничего не публикует и не списывает денег.
#Где лежат настройки
В файле config.panel.php рядом с сайтом. Его пишет панель.
Правьте настройки через панель. Файл переписывается целиком при каждом сохранении, и ручная правка исчезнет со следующим нажатием «Сохранить».
Значения из панели ложатся поверх того, что задано в config.secret.php
при установке сайта. Пустое значение не перетирает заданное — поэтому
настройку, прописанную при установке, панель не сотрёт по недосмотру.
Файл закрыт от прямых запросов, а в выгрузку базы ключи не попадают вовсе: они лежат на диске, а не в таблицах.
#Что чаще всего идёт не так
«Сохранил, а ничего не изменилось». Проверьте, что заполнены оба поля пары: у Telegram это токен и чат, у оплаты — терминал и пароль. Сервис с половиной реквизитов просто пропускается.
«Проверка отвечает „ключ не задан“». Смотрите строку «Сохранено» под полем: если её нет, ключ и правда не сохранён. Само поле ввода всегда пустое — это не признак того, что ключа нет.
«Заявки не приходят, а бот отвечает». Уведомления о заявках и Telegram-канал — разные боты и разные чаты. Проверять надо тот сервис, который отвечает за заявки.