GET токен
Материал из Документация Ключ-АСТРОМ
Версия от 12:01, 25 октября 2022; ENetrebin (обсуждение | вклад) (Новая страница: «Получает метаданные API-токена по его идентификатору. Запрос создает в качестве полезной...»)
Получает метаданные API-токена по его идентификатору.
Запрос создает в качестве полезной нагрузки application/json
формат.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/apiTokens/{id}
|
Среда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/apiTokens/{id}
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью чтения токенов API ( apiTokens.read
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
id | string | Идентификатор токена. | дорожка | требуется |
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | ApiToken | Успех |
400 | ErrorEnvelope | Не удалось. Ввод недействителен. |
404 | Не удалось. Запрошенный ресурс не существует. |
Объекты тела ответа
Объект ApiToken
Метаданные токена API.
Элемент | Тип | Описание |
---|---|---|
lastUsedIpAddress | string | Последний использованный токеном IP-адрес. |
modifiedDate | string | Дата последнего изменения токена в формате ISO 8601 ( yyyy-MM-dd'T'HH:mm:ss.SSS'Z' ). Обновление областей действия или имени считается модификацией, а включение или отключение токена — нет.
|
additionalMetadata | object | Содержит дополнительные свойства для определенных типов токенов. Примеры:
|
expirationDate | string | Срок действия токена в формате ISO 8601 ( yyyy-MM-dd'T'HH:mm:ss.SSS'Z' ).
Если не установлено, срок действия токена никогда не истекает. |
personalAccessToken | boolean | Токен представляет собой токен личного доступа ( true ) или токен API ( false ).
|
lastUsedDate | string | Дата последнего использования токена в формате ISO 8601 ( yyyy-MM-dd'T'HH:mm:ss.SSS'Z' )
|
creationDate | string | Дата создания токена в формате ISO 8601 ( yyyy-MM-dd'T'HH:mm:ss.SSS'Z' )
|
enabled | boolean | Маркер включен ( true ) или отключен ( false ).
|
scopes | string[] | Список областей, назначенных маркеру.
Элемент может содержать эти значения
|
name | string | Имя токена. |
id | string | Идентификатор токена, состоящий из префикса и общедоступной части токена. |
owner | string | Владелец токена. |
JSON-модель тела ответа
{
"lastUsedIpAddress": "34.197.2.44",
"modifiedDate": "2020-11-12T08:15:30.144Z",
"additionalMetadata": {
"dashboardId": "82402bab-7370-4359-924d-88ed13c8919a"
},
"expirationDate": "2020-11-12T08:15:30.144Z",
"personalAccessToken": true,
"lastUsedDate": "2020-11-12T08:15:30.144Z",
"creationDate": "2020-11-05T08:15:30.144Z",
"enabled": true,
"scopes": [
"metrics.read"
],
"name": "myToken",
"id": "dt0c01.ST2EY72KQINMH574WMNVI7YN",
"owner": "john.smith"
}