В этой истории
Где: Настройки → Дополнительно → Подключение приложений
Откройте страницу: admin.<your-site>/settings/integrations (замените <your-site> адресом вашего сайта). Если пункта нет в меню, включите Показать все настройки в настройках.
Перед началом
- Создавать ключи может только владелец сайта.
Инструкция
- Откройте Настройки → Дополнительно → Подключение сервисов → Ключи API.
- Нажмите Создать ключ.
- Укажите Название, например «Сайт партнера».
- В блоке Что он может делать? отметьте нужные доступы:
- Чтение материалов: опубликованные статьи без платного контента.
- Чтение платного контента целиком: также полный текст платных публикаций.
- Отправка черновиков: добавление статей в черновики. Без вашей команды ничего не публикуется.
- Отправка фото: добавление фотографий в медиатеку по ссылке.
- Чтение разделов и тегов.
- Чтение статистики посещаемости: просмотры материалов и общее число посетителей.
- Чтение финансовых отчетов: только общие суммы, без данных читателей.
- По желанию укажите Действует до, Разрешенные адреса (по одному в строке, до 20), Запросов в минуту (от 1 до 600) и Запросов в день (от 1 до 1 000 000).
- Нажмите Создать ключ.
- Скопируйте ключ из поля. Он показывается только один раз. Нажмите Я сохранил.
- Передайте ключ внешнему сервису. Он передается в заголовке «Authorization: Bearer».
Полезно знать
- В списке отображаются Название, Разрешения, Использовался, Истекает и Статус: Работает, Истек или Остановлено каждого ключа.
- Создать новый ключ заменяет ключ на новый. Старый продолжит работать выбранный вами срок, либо выберите Остановить сейчас, если ключ был скомпрометирован.
- Остановить ключ сразу блокирует все запросы с этим ключом. Отменить действие нельзя. Чтобы вернуть доступ, создайте новый ключ.
- В деталях ключа видна статистика его использования за последние 30 дней.
- У каждого ключа свои ограничения. Запросы приложения замедляются, если оно обращается слишком часто.
- Ключ с доступом к платным статьям открывает платные материалы любому, у кого он есть. Храните его в безопасности.
Частые проблемы
- «Вы достигли лимита ключей. Сначала отключите ключ, который больше не используется.»
- «Укажите имя ключа.»
- «Выберите хотя бы одно действие, разрешенное для ключа.»
- «Выберите дату в будущем.»
Вопросы
Часто задаваемые вопросы
Можно ли посмотреть ключ позже?
Нет. Если вы его потеряли, создайте новый ключ.
Можно ли использовать один ключ для нескольких приложений?
Да, но лучше создать для каждого сервиса отдельный ключ, чтобы при необходимости отключить только один из них.