Developers

OAuth 2.0

OAuth 2.0

Получение access_token

Для получения токена доступа access_token необходимо отправить на сервер авторизации POST-запрос с вашими данными.

Параметры client_id и client_secret можно получить в личном кабинете.

Запрос на получение токена (HTTP):
https://auth2.cityads.com/oauth/access_token
{
    "client_id": "client_id_string",
    "client_secret": "client_secret_string",
    "grant_type": "client_credentials"
}
                    
Запрос на получение токена (cURL):
curl -L -X POST \
    -H "Content-Type:application/json" \
    -d \
'{
    "client_id": "client_id_string",
    "client_secret": "client_secret_string",
    "grant_type": "client_credentials"
}' \
'https://auth2.cityads.com/oauth/access_token'
                    
Входные данные:
Имя:
client_id Идентификатор пользователя. Доступен в личном кабинете.
client_secret Секретный ключ пользователя. Доступен в личном кабинете.
grant_type Тип запроса – "client_credentials".
Ответ сервера:

В ответ сервер вернёт JSON вида

{
    "access_token": "mmMy2dZEeoMm13Fr7X6uc8TaP5262Qjin717P67Z",
    "token_type": "Bearer",
    "expires_in": 3600
}
                    
Параметры ответа:
Имя:
access_token Токен для запросов к API.
token_type Тип токена – "Bearer".
expires_in Срок жизни выданного токена в секундах.
Использование access_token

Полученное значение access_token следует добавлять в виде GET-параметра ко всем типам запросов нового API вебмастера.

Например:

GET https://cityads.com/api/rest/webmaster/v2/lostOrders?offers=4325,663&page=1&perpage=10
&access_token=Cr9G7dVD0FZMGaqrR9EPXXSl1J6A27AnJrNnl6Qi
                    

В случае изменения пароля к личному кабинету, все выданные токены становятся недействительными.