Настройки
Настройки разработчика
Личные ключи, клиенты приложений и подключение агента или CLI: элементы управления страницы Sofia API и как выбрать подходящий.
Этот раздел — вход во всё программное. Справочная документация находится на вкладках API, Agents и «Добавьте Sofia в своё приложение»; эта страница описывает элементы интерфейса. Откройте настройки, раздел «Sofia API».
Доступ
На странице две вкладки: «Личный доступ» и «Клиенты приложений».
Ваш личный ключ
- Создайте ключ. «Новый ключ»: при желании дайте ему имя, задайте срок действия (7 дней, 30 дней, 90 дней, 1 год или бессрочно) и разрешения. По умолчанию отмечены все; оставьте только то, что нужно вашему инструменту.
- Скопируйте его сразу. Он показывается один раз, а Sofia хранит лишь его отпечаток.
- Используйте его. Передавайте в заголовке
Authorization: Bearerкаждого вызова. Ключ действует во всех ваших заведениях с вашими правами.
Подключение ИИ-ассистента
Для Claude, ChatGPT, Cursor, Gemini CLI или Claude Code коннектор из подключённых приложений часто проще: ключ не нужен. См. ИИ-коннектор.
CLI и агенты
«Скопировать инструкции для агента» даёт текст, который нужно вставить в вашего агента, чтобы он использовал API. Команда sofia, опубликованная в npm под именем sofia-post, оборачивает API для публикации из терминала, скрипта или запланированной задачи; её установка описана на вкладке Agents.
Клиенты приложений
Клиент приложения нужен, чтобы создать то, что будут авторизовать другие пользователи Sofia, а не то, что действует от вашего имени.
- Создайте клиента. «Новый клиент»: название, логотип не менее 180 × 180 пикселей, адрес вашей политики конфиденциальности, от одного до пяти URL перенаправления по HTTPS и разрешения, которые приложение может запрашивать. Название и логотип показываются людям во время авторизации.
- Скопируйте идентификаторы. Вы получаете Client ID и Client Secret. У публичного клиента, для приложения с открытым кодом, секрета нет, и он аутентифицируется с PKCE; этот выбор окончателен.
- Реализуйте процесс. См. вкладку «Добавьте Sofia в своё приложение».
Ключ или клиент OAuth?
| Критерий | Личный ключ | Клиент приложения |
|---|---|---|
| Действует как | Вы | Человек, который его авторизует |
| Подходит для | Ваших собственных скриптов и автоматизаций | Продукта, которым будут пользоваться другие пользователи Sofia |
| Настройка | Скопировать ключ | Объявить клиента и реализовать процесс |
| Как отозвать | «Отозвать доступ» у ключа | Человек снимает доступ в «Подключённые приложения», или вы удаляете клиента |
Если вы автоматизируете собственные публикации, используйте ключ. Создавайте клиента, только когда речь идёт об аккаунтах других людей.
Чтобы пойти дальше
- API: точки доступа, полезная нагрузка и настройки по сетям, на вкладке API.
- CLI: публикация из терминала, на вкладке Agents.
- ИИ-коннектор: подключение Claude, Cursor или ChatGPT, см. ИИ-коннектор.