Заведения

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

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

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

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

Авторизации

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

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

Хранится только в этой вкладке и отправляется только на api.sofia-post.com. Получить ключ API

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

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

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

Тело

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

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

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"}'

{
  "platform": "tiktok",
  "url": "string",
  "expiresAt": "string"
}

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

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

{
  "platform": "tiktok",
  "url": "string",
  "expiresAt": "string"
}

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

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.

Авторизации

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

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

idstringобязательно
Идентификатор заведения.

Тело

application/json

platformstringобязательно
Сеть, которую нужно подключить
Допустимые значения: instagramfacebooktiktoklinkedinx
redirectUrlstring
Куда отправить человека в конце, если Sofia узнаёт этот источник; иначе страница Sofia сообщит, что всё готово

Ответ

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

platformstringобязательно
Сеть, которую нужно подключить
urlstringобязательно
Страница Sofia, которую человек открывает, чтобы подключить сеть
expiresAtstringобязательно
До какого момента ссылка ждёт перехода (ISO 8601)

Эта страница была полезной?