Использование мультисайтового API токена в API запросах

Получить мультисайтовый API токен Мультисайтовый API токен вид API токена в Calltouch, который позволяет осуществлять авторизованный доступ к данным и функциям сразу нескольких проектов. Авторизация с мультисайтовым токеном происходит через специальные заголовки или параметры запроса, позволяя обращаться к разным проектам без необходимости создавать отдельные токены для каждого из них. Глоссарий Вы можете в настройках пользователя, во вкладке API:

Перейдя в указанную вкладку — вы увидите экран управления мультисайтовыми API токенами. Тут вы можете создать новый токен или скопировать существующий.

При использовании в API методах мультисайтового API токена:

1) Для обычных API методов, с передачей авторизационных данных в заголовках запроса.

Авторизация происходит по 2-м заголовкам в запросе — API токену и ID сайта:

• Access-Token: мультисайтовый API токен
• SiteId: Id сайта

То есть, при использовании мультисайтового токена — авторизационные данные отправляются аналогично, как и при использовании обычного API токена.

2) Для обычных API методов, с передачей авторизационных данных в теле POST или GET запроса:

Авторизация происходит по 2 параметрам — API токену и ID сайта:

• Мультисайтовый API токен передается в параметре clientApiId
• ID сайта передается в URL запроса. Для API запросов, у которых передача ID сайта в URL запроса не предусмотрено — его надо передавать в отдельном параметре siteId.

То есть, при использовании мультисайтового токена — авторизационные данные отправляются аналогично, как и при использовании обычного API токена. Исключение составляют API методы, в которых при использовании обычного API токена передача ID сайта не предусмотрена, для таких методов надо просто добавить параметр siteId в тело запроса, передав в него ID сайта.