Релиз добавляет публичный API блогов — возможность использовать данные о платных подписках на сторонних сайтах, в Телеграм-ботах и прочих сервисах. Функционал состоит из двух частей: API-ключи для владельцев блогов и токены доступа для пользователей.
1. API-ключи
Это секретный ключ, который позволяет автору настроить интеграцию с блогом на Гапи на стороннем сервисе — на собственном сайте, в Телеграм-боте и т. д.
Ключ генерируется в основном меню блога.
Вы можете создать до 10 ключей на один блог — это позволяет настроить независимую интеграцию с несколькими сервисами.
Для каждого ключа заданы лимиты на использование: по умолчанию допускается не больше 100 запросов в секунду и не больше 1000 в минуту. Большинству блогов таких лимитов будет достаточно, если вам нужно больше, напишите в службу поддержки по почте support@gapi.ru
Описание API для интеграции доступно в документе для разработчиков. Документ подходит для создания обработчика при помощи ИИ — просто дайте агенту URL, либо скопируйте текст, если агент не может получить к нему прямой доступ, и попросите написать код интеграции.
2. Токены доступа
Для подтверждения уровня подписки пользователь должен передать стороннему сервису (сайт, Телеграм-бот и т. д.) токен доступа.
Токен заменяет одновременно идентификатор пользователя и пароль: он уникален и не поддаётся угадыванию перебором.
Кроме того, никакие персональные данные пользователя не содержатся в самом токене и не передаются сторонним сервисам в ответах API — это избавляет пользователей от рисков утечки персональных данных, а владельцев сервисов — от необходимости регистрироваться в качестве ОПД.
Для генерации токена зайдите на страницу блога, на который вы подписаны, и выберите пункт «Токен доступа» в основном меню.
Не передавайте сгенерированный токен никому, кроме доверенных сервисов владельца блога. В случае утечки токена вы можете в любой момент сгенерировать его заново — в этом случае старый токен будет удалён, а ранее настроенные интеграции перестанут работать, что потребует повторной регистрации в тех сервисах, которые его использовали.