Obtención del token de la empresa
Cómo obtener el token de proveedor en el token de API abierta para la integración con la empresa seleccionada.
La traducción no está disponible. Se muestra el original.
Для обмена данными через Open API нужны два токена:
- Open API token подтверждает доступ вашей интеграции;
- provider token указывает компанию, с данными которой выполняется запрос.
Используйте отдельный токен интеграции, созданный через интерфейс Synchra24. Не копируйте токены входа пользователя из браузера или мобильного приложения.
Что подготовить
- Создайте токен Open API для нужной компании.
- Уточните идентификатор этой компании —
provider_id. Его можно получить из интерфейса компании, например из адреса открытого раздела веб-версии. - Получите токен компании запросом ниже.
Запрос токена компании
GET /api/v1/providers/user/params/{provider_id}
X-OpenAPI-Token: <OPEN_API_TOKEN>
Вместо {provider_id} укажите идентификатор компании, для которой создан токен интеграции.
Пример:
curl --request GET \
--url https://getway.synchra24.com/api/v1/providers/user/params/123 \
--header 'X-OpenAPI-Token: <OPEN_API_TOKEN>'
В ответе возьмите значение result.token. Это токен компании для следующих запросов.
Следующие запросы
Передавайте оба заголовка:
X-OpenAPI-Token: <OPEN_API_TOKEN>
X-Provider-Token: <PROVIDER_TOKEN>
Content-Type: application/json
Для работы с другой компанией нужны токены, выданные для неё. Нельзя подставить чужой идентификатор компании и получить доступ по токену своей интеграции.
Ошибки и безопасность
Если запрос отклонён, проверьте правильность идентификатора компании, срок действия токена Open API, подписку и права сотрудника, от имени которого создана интеграция.
Храните токены на стороне своей интеграции и не публикуйте их в открытом коде, переписке или снимках экрана. Если токен Open API раскрыт, отзовите его в настройках компании и создайте новый.
Доступные методы и правила авторизации приведены в Open API.