ENetrebin (обсуждение | вклад) Нет описания правки |
Нет описания правки |
||
| (не показана 1 промежуточная версия этого же участника) | |||
| Строка 1: | Строка 1: | ||
'''''[[API АппОптима]] / [[API АппОптима|Эндпойнты среды]] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=DELETE%20%D1%82%D0%B5%D0%B3%D0%BE%D0%B2-,%D0%A0%D0%B0%D0%B7%D0%B2%D1%91%D1%80%D1%82%D1%8B%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5,-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C Развёртывание] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=PUT%20%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8F-,%D0%A2%D0%BE%D0%BA%D0%B5%D0%BD%D1%8B%20v2,-%D0%A2%D0%BE%D0%BA%D0%B5%D0%BD%D1%8B%20%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%B0 Токены v2] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=%D0%A2%D0%BE%D0%BA%D0%B5%D0%BD%D1%8B%20v2-,%D0%A2%D0%BE%D0%BA%D0%B5%D0%BD%D1%8B%20%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%B0,-GET%20%D0%B2%D1%81%D0%B5%20%D1%82%D0%BE%D0%BA%D0%B5%D0%BD%D1%8B Токены доступа] / POST поиск токена''''' | |||
Получает метаданные токена API по его секрету. | Получает метаданные токена API по его секрету. | ||
| Строка 4: | Строка 6: | ||
{| class="wikitable" | {| class="wikitable" | ||
| rowspan="2" |POST | | rowspan="2" |POST | ||
| | |АппОптима | ||
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/apiTokens/lookup</nowiki></code> | |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/apiTokens/lookup</nowiki></code> | ||
|- | |- | ||
| Строка 46: | Строка 48: | ||
=== JSON-модель тела запроса === | === JSON-модель тела запроса === | ||
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе. | Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе. | ||
< | <{ | ||
"token": "dt0c01.ST2EY72KQINMH574WMNVI7YN.G3DFPBEJYMODIDAEX454M7YWBUVEFOWKPRVMWFASS64NFH52PX6BNDVFFM572RZM" | "token": "dt0c01.ST2EY72KQINMH574WMNVI7YN.G3DFPBEJYMODIDAEX454M7YWBUVEFOWKPRVMWFASS64NFH52PX6BNDVFFM572RZM" | ||
} | } | ||
== Ответ == | == Ответ == | ||
| Строка 211: | Строка 213: | ||
=== JSON-модель тела ответа === | === JSON-модель тела ответа === | ||
< | <{ | ||
"lastUsedIpAddress": "34.197.2.44", | "lastUsedIpAddress": "34.197.2.44", | ||
"modifiedDate": "2020-11-12T08:15:30.144Z", | "modifiedDate": "2020-11-12T08:15:30.144Z", | ||
| Строка 228: | Строка 230: | ||
"id": "dt0c01.ST2EY72KQINMH574WMNVI7YN", | "id": "dt0c01.ST2EY72KQINMH574WMNVI7YN", | ||
"owner": "john.smith" | "owner": "john.smith" | ||
} | } | ||
Текущая версия от 17:27, 2 января 2025
API АппОптима / Эндпойнты среды / Развёртывание / Токены v2 / Токены доступа / POST поиск токена
Получает метаданные токена API по его секрету.
Запрос создает и использует в качестве полезной нагрузки application/json формат.
| POST | АппОптима | https://{your-domain}/e/{your-environment-id}/api/v2/apiTokens/lookup
|
| Среда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/apiTokens/lookup
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с любой областью действия. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | In | Необходимость |
|---|---|---|---|---|
| body | ApiTokenSecret | Тело JSON запроса. Содержит требуемый токен. | body | требуется |
Объекты тела запроса
Объект ApiTokenSecret
| Элемент | Тип | Описание | Необходимость |
|---|---|---|---|
| token | string | Токен API | требуется |
JSON-модель тела запроса
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
<{
"token": "dt0c01.ST2EY72KQINMH574WMNVI7YN.G3DFPBEJYMODIDAEX454M7YWBUVEFOWKPRVMWFASS64NFH52PX6BNDVFFM572RZM"
}
Ответ
Коды ответов
| Код | Тип | Описание |
|---|---|---|
| 200 | ApiToken | Успех |
| 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"
}