API-ключи и аутентификация

API-ключ позволяет вашему собственному коду, SDK Posty5, n8n и ИИ-ассистентам работать с вашим аккаунтом Posty5. На этой странице объясняется, как работают ключи, а другие страницы для разработчиков дают ссылку сюда, а не повторяют это.

Получите аккаунт разработчика

API-ключи — функция аккаунта разработчика. Переход бесплатный и вступает в силу сразу. Он не меняет ваш тариф и ваши кредиты.

В панели управления Posty5 откройте «Настройки аккаунта» и выберите «API-ключи».
Выберите «Перейти на аккаунт разработчика». Страница перезагрузится и покажет ваши API-ключи и способы подключения к Posty5.

Откройте раздел «API-ключи» в панели управления

Создайте ключ

В разделе «API-ключи» выберите «Создать API-ключ».
Дайте ключу название, по которому понятно, где он используется, например «Контактная форма на сайте». Название видите только вы.
Выберите область записей (см. ниже) и нажмите «Создать». Новый ключ появится вместе с кнопкой копирования.

Ключ показывается не один раз. В списке каждый ключ отображается скрытым, а кнопка копирования снова копирует ключ целиком, когда он вам нужен. Переименовать ключ или изменить его область записей можно в его действиях в списке.

Передавайте ключ с каждым запросом

Передавайте ключ в этом заголовке каждого запроса к API Posty5 —

API доступен по адресу

Чтобы проверить ключ, вызовите маршрут, который его описывает. В ответе будут ключ, его владелец, тариф и кредиты, которые аккаунт может потратить. Отозванный или неизвестный ключ получит 401.

curl https://api.posty5.com/api/api-key/current \
  -H "X-API-Key: YOUR_API_KEY"

SDK и узлы n8n используют тот же ключ.

Клиент	Куда вставить ключ	Подробнее
JavaScript / TypeScript	`new HttpClient({ apiKey: "YOUR_API_KEY" })`	npm-sdk
.NET	`new Posty5Options { ApiKey = "YOUR_API_KEY" }`	dotnet-sdk
n8n	Учётные данные Posty5 API, поле API Key	n8n-nodes

Выберите, что может видеть ключ

У каждого ключа есть область записей. Она определяет, какие ваши записи ключ может просматривать в списке и изменять.

Область записей	Что ключ может просматривать и изменять
Только записи, созданные с этим ключом	Только записи, созданные этим ключом. Записи, созданные вами в панели управления или другим ключом, ему недоступны, поэтому две интеграции никогда не затрагивают работу друг друга.
Весь мой аккаунт	Все записи в вашем аккаунте, где бы они ни были созданы. Обычно это нужно ИИ-ассистенту, ведь вы спрашиваете его о том, что создали сами.

Новый ключ по умолчанию получает вариант «Только записи, созданные с этим ключом» — как и все ключи, созданные до появления этой настройки. Чтобы изменить его, откройте действия ключа и выберите «Изменить область записей». MCP-ссылка ключа использует его область записей.

Последнее использование и отзыв ключа

Столбец «Последнее использование» показывает, когда ключ в последний раз отправил запрос. Он обновляется не чаще одного раза в несколько минут, поэтому у постоянно используемого ключа время может отставать на несколько минут.

Чтобы отозвать ключ, откройте его действия в списке, выберите «Отозвать» и подтвердите.

Ключ сразу перестаёт работать. Каждое приложение, скрипт и интеграция, которые его используют, получат 401 при следующем запросе.
Его ссылка для ИИ-ассистента (MCP) перестаёт работать в тот же момент.
Отзыв нельзя отменить. Если ключ снова понадобится, создайте новый.
Всё, что ключ уже сделал, сохраняется. Созданные им записи остаются в вашем аккаунте, а запланированные им публикации выйдут вовремя, потому что запланированная публикация не использует ключ.

Кредиты

Вызов с API-ключом стоит ровно столько же, сколько то же действие в панели управления, а кредиты списываются с аккаунта, которому принадлежит ключ. Цена каждого действия указана на странице Кредиты функций

Обеспечьте безопасность ключей

Храните ключи на сервере. Никогда не размещайте ключ на веб-странице, в мобильном приложении или публичном репозитории — любой, кто его прочитает, сможет действовать от вашего имени.
Ключ не может управлять ключами. Создавать, просматривать, переименовывать и отзывать ключи можно только после входа в Posty5, поэтому утёкший ключ не сможет прочитать другие ваши ключи или создать новые.
Чтобы выполнить ротацию ключа, создайте новый, переведите на него интеграцию, убедитесь, что дата «Последнее использование» у нового ключа обновляется, а затем отзовите старый ключ.
Если ключ утёк, сразу отзовите его и создайте новый.