Api School-master
В основных настройках SM, включить пункт «Активировать api-доступ».
После этого вы получите два токена: «access_token», «refresh_token». А также дату истечения сроков использования (6 лет).
Access_token – токен для получения каких-либо данных, выполнения операций.
Refresh_token – для обновления пары этих токенов, когда срок использования истечет.
Когда срок действия этих токенов закончится, необходимо получить новую пару. Как это сделать написано ниже.
Если нужно сгенерировать ещё пару токенов, например для другой системы, то достаточно нажать на сгенерировать новые данные для API v2.
Тогда вы получите новую пару токенов.
****Чтобы запрос на сервере SM был выполнен, необходимо при запросе на сервер, иметь заголовок «Auth» со значением «access_token». Иначе, сервер отдаст ответ с статус кодом 403 (не авторизован). Такой же будет ответ в случае, если токен устареет.
Обновление токенов происходит с помощью обращения к серверу. При запросе, необходимо в заголовке поле «Auth» со значением «refresh_token».
URL: /api2/refreshtoken
Method: GET
При любом запросе приходит ответ вида:
{"status": true, "result": string / array, "error": null}