{"openapi":"3.0.3","info":{"title":"1.19. API ЕСИА. Получение маркера доступа (токена)","description":"Маркер доступа на специальный scope (http://esia.gosuslugi.ru/ext_imp) позволяет осуществлять автоматический импорт учетной записи пользователя. Данный маркер выдается только доверенным системам, имеющим право импорта пользователей таким образом. Выдача маркера осуществляется в рамках модели контроля доступа на основе полномочий системы-клиента, т.е. право на запрос такого маркера доступа устанавливается оператором эксплуатации ЕСИА. Для получения маркера доступа система-клиент должна направить по https-адресу сервиса авторизации ЕСИА запрос методом POST.","termsOfService":"https://esia.gosuslugi.ru","contact":{"name":"Федеральный ситуационный центр","email":"sd@sc.minsvyaz.ru","url":"https://sc.minsvyaz.ru"},"license":{"name":"Apache 2.0","url":"https://www.apache.org/licenses/LICENSE-2.0.html"},"version":"1.0.0"},"servers":[{"url":"https://esia.gosuslugi.ru","description":"url продуктивной среды"},{"url":"https://esia-portal1.test.gosuslugi.ru","description":"url тестового стенда"}],"tags":[{"name":"Сервис авторизации ЕСИА"}],"paths":{"/aas/oauth2/te":{"post":{"tags":["Сервис авторизации ЕСИА"],"summary":"Получение маркера доступа","description":"Получение маркера доступа (security access token) на специальный scope http://esia.gosuslugi.ru/ext_imp","operationId":"getAccessTokenUsingPost","requestBody":{"description":"Данные от системы-клиенты для получения маркера доступа","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessTokenRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessTokenRequestSuccessResponse"}}}},"400":{"description":"Ошибка при получение маркера доступа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessTokenRequestErrorResponse"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"AccessTokenRequest":{"required":["client_id","client_secret","grant_type","response_type","scope","state","timestamp","token_type"],"type":"object","additionalProperties":false,"properties":{"client_id":{"type":"string","maxLength":32,"minLength":3,"pattern":"^[A-Z\\d_-]{3,32}$","description":"Идентификатор системы-клиента (мнемоника системы в ЕСИА указанная прописными буквами)","example":"TEST_SYSTEM_IMPORT"},"client_secret":{"type":"string","maxLength":8200,"description":"Подпись запроса в формате PKCS#7 detached signature в кодировке UTF-8 от значений четырех\nпараметров HTTP–запроса: scope, timestamp, clientId, state (без разделителей).\n<client_secret> должен быть закодирован в формате base64 url safe. Используемый для\nформирования подписи сертификат должен быть зарегистрирован в ЕСИА и привязан к учетной\nзаписи системы-клиента в ЕСИА. ЕСИА поддерживает сертификаты в формате X.509. ЕСИА\nподдерживает алгоритм формирования электронной подписи ГОСТ Р 34.10-2012 и алгоритм\nкриптографического хэширования ГОСТ Р 34.11-2012.","example":"MIIEuwYJKoZIhvcNAQcCoIIErDCCBKgCAQExD..."},"grant_type":{"type":"string","description":"Принимает значение “client_credentials”, если используется модель контроля доступа на\nоснове полномочий системы-клиента. В данной модели невозможно указывать пользовательские\nscope, необходимо указывать только scope организаций.","example":"client_credentials","enum":["client_credentials"]},"response_type":{"type":"string","description":"Используемая модель контроля доступа; принимает значение “token”, если происходит\nбезусловное наделения системы-клиента полномочиями","example":"token","enum":["token"]},"scope":{"type":"string","description":"Область доступа, т.е. запрашиваемые права; например, если система-клиент запрашивает\nдоступ к данным ИНН организации, то scope должно иметь значение\nhttp://esia.gosuslugi.ru/org_inn с параметрами","example":"http://esia.gosuslugi.ru/ext_imp","enum":["http://esia.gosuslugi.ru/ext_imp"]},"state":{"type":"string","format":"uuid","minLength":36,"maxLength":36,"description":"Набор случайных символов, имеющий вид 128-битного идентификатора запроса (необходимо для\nзащиты от перехвата), генерируется по стандарту UUID; этот набор символов должен\nотличаться от того, который использовался при получении авторизационного кода.","example":"9be638a9-0e05-42e1-b4f8-a3e30457fbdd"},"timestamp":{"maxLength":25,"pattern":"^((19|20)[0-9][0-9])[.](0[1-9]|1[012])[.](0[1-9]|[12][0-9]|3[01])[ ]([01][1-9]|[2][0-3])[:]([0-5][0-9])[:]([0-5][0-9])[ ](Z|[+-](?:2[0-3]|[01][0-9])[0-5][0-9])$","type":"string","description":"Время запроса маркера в формате yyyy.MM.dd HH:mm:ss Z, необходимое для фиксации начала\nвременного промежутка, в течение которого будет валиден запрос с данным идентификатором\n(<state>)","example":"2013.01.25 14:36:11 +0400"},"token_type":{"type":"string","description":"Тип запрашиваемого маркера (ЕСИА поддерживает только значение “Bearer”)","example":"Bearer","enum":["Bearer"]}},"description":"Тело запроса на получение маркера доступа (security access token) на специальный"},"AccessTokenRequestErrorResponse":{"title":"AccessTokenRequestErrorResponse","required":["error","error_description","state"],"type":"object","additionalProperties":false,"properties":{"error":{"maxLength":50,"type":"string","description":"Код ошибки при при получении маркера доступа","example":"invalid_scope"},"error_description":{"maxLength":400,"type":"string","description":"Описание ошибки при получении маркера доступа","example":"ESIA-007006: The requested scope is invalid, unknown, or malformed."},"state":{"type":"string","format":"uuid","minLength":36,"maxLength":36,"description":"Набор случайных символов, имеющий вид 128-битного идентификатора запроса, генерируется по стандарту UUID (совпадает с идентификатором запроса)","example":"9be638a9-0e05-42e1-b4f8-a3e30457fbdd"}},"description":"Тело ответа на запрос при невозможности выдачи маркера доступа (security access token) на специальный scope http://esia.gosuslugi.ru/ext_imp"},"AccessTokenRequestSuccessResponse":{"required":["access_token","expires_in","state","token_type"],"type":"object","additionalProperties":false,"properties":{"access_token":{"maxLength":8200,"type":"string","description":"Маркер доступа для данного ресурса (security access token).\nДанный маркер доступа должен передаваться в заголовке (Authorization: Bearer) всех запросов.","example":"eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6M"},"expires_in":{"minimum":600,"maximum":10800,"type":"integer","description":"Время, в течение которого истекает срок действия маркера (в секундах)","format":"int32","example":3600},"state":{"type":"string","format":"uuid","minLength":36,"maxLength":36,"description":"Набор случайных символов, имеющий вид 128-битного идентификатора запроса, генерируется по\nстандарту UUID (совпадает с идентификатором запроса)","example":"9be638a9-0e05-42e1-b4f8-a3e30457fbdd"},"token_type":{"type":"string","description":"Тип предоставленного маркера (ЕСИА поддерживает только значение “Bearer”)","example":"Bearer","enum":["Bearer"]}},"description":"Тело ответа на запрос маркера доступа (security access token) на специальный scope\nhttp://esia.gosuslugi.ru/ext_imp"}}}}