ЗаведенияСоздать ссылку для подключения
Назад к Sofia

Заведения

Создать ссылку для подключения

Возвращает размещённую ссылку, где человек разрешает сети доступ к Sofia, и токен сети не попадает в ваше приложение. Действует 30 минут; только live.

POSThttps://api.sofia-post.com/api/v1/establishments/{id}/connection-links
POST/v1/establishments/{id}/connection-links

Этот запрос действует на ваш реальный аккаунт.

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

Авторизации

  • Authorizationstringобязательно

    Ваш личный ключ или токен доступа OAuth, отправляется как Bearer <token>.

Параметры пути

  • idstringобязательно

    Идентификатор заведения.

Тело

application/json

  • platformstringобязательно

    Сеть, которую нужно подключить

    Допустимые значения: instagramfacebooktiktoklinkedinx

  • redirectUrlstring

    Куда отправить человека в конце, если Sofia узнаёт этот источник; иначе страница Sofia сообщит, что всё готово

Ответ

201application/json

Размещённая ссылка для подключения и срок её действия.

  • platformstringобязательно

    Сеть, которую нужно подключить

  • urlstringобязательно

    Страница Sofia, которую человек открывает, чтобы подключить сеть

  • expiresAtstringобязательно

    До какого момента ссылка ждёт перехода (ISO 8601)

401

Токен отсутствует, неизвестен, просрочен или отозван.

402

subscription_required.

403

live_mode_required для тестового приложения или нет разрешения accounts:write.

404

Заведение вне Workspace токена.

409

account_already_connected: сеть уже подключена.

422

platform_not_offered: сеть не предлагается.

4XXapplication/json

Любая другая ошибка в конверте ошибки.