Заведения и аккаунты

Получить ключ API

Эндпоинты

GET/v1/establishmentsGET/v1/establishments/{id}/accountsPOST/v1/establishments/{id}/connection-links

Заведение: бизнес, бренд или место со своими сетями, медиа и публикациями. В Workspace одно или несколько заведений.

Подключённые аккаунты

GET /v1/establishments/{id}/accounts возвращает подключённые сети: платформу, handle, имя, аватар и статус. Sofia никогда не отдаёт токен сети.

Подключение недостающей сети

Создайте размещённую ссылку для подключения и отправьте владельца по ней. Ссылка действует 30 минут; в конце Sofia возвращает его на ваш redirectUrl, если Sofia узнаёт его источник.

bash
curl -X POST https://api.sofia-post.com/api/v1/establishments/$ESTABLISHMENT_ID/connection-links \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"platform":"linkedin","redirectUrl":"https://app.example.com/sofia/connected"}'

Уже подключённая сеть отвечает 409 account_already_connected; сеть, которую Sofia не предлагает, отвечает 422 platform_not_offered.