Для AI-агентов: markdown этой страницы — /docs/api-op-getcatalogitem.md · индекс документации — /llms.txt
getCatalogItem
Обновлено
GET /api/v1/catalog/{seq_id}
getCatalogItem
#Авторизация и права
Scopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.
| Поле | Значение |
|---|
| security.0.hubApiKey | [] |
| security.1.hubBearer | [] |
| securitySchemes.hubApiKey.in | "header" |
| securitySchemes.hubApiKey.name | "X-Api-Key" |
| securitySchemes.hubApiKey.type | "apiKey" |
| securitySchemes.hubBearer.scheme | "bearer" |
| securitySchemes.hubBearer.type | "http" |
| x-required-scopes | ["catalog:read"] |
#Параметры запроса
| Поле | Значение |
|---|
| 0.in | "path" |
| 0.name | "seq_id" |
| 0.required | true |
| 0.schema | 0.schema |
| 1.in | "query" |
| 1.name | "zone" |
| 1.required | false |
| 1.schema | 1.schema |
| 2.in | "header" |
| 2.name | "If-None-Match" |
| 2.required | false |
| 2.schema | 2.schema |
#Тело запроса
| Поле | Значение |
|---|
| Тело запроса | null |
#Ответы
| Поле | Значение |
|---|
| 200.content.application/json.schema | CatalogDetail |
| 200.description | "Get catalog item detail" |
| 200.headers.ETag.description | "Weak ETag for the current catalog item representation" |
| 200.headers.ETag.required | true |
| 200.headers.ETag.schema | 200.headers.ETag.schema |
| 304.description | "Not modified: If-None-Match equals the current ETag; response has no body" |
| 304.headers.ETag.description | "Weak ETag for the current catalog item representation" |
| 304.headers.ETag.required | true |
| 304.headers.ETag.schema | 304.headers.ETag.schema |
#Ошибки
| Поле | Значение |
|---|
| 400.content.application/problem+json.schema | ProblemDetails |
| 400.description | "Catalog sequence or zone does not match the request schema" |
| 401.content.application/problem+json.schema | ProblemDetails |
| 401.description | "Missing or invalid authentication" |
| 403.content.application/problem+json.schema | ProblemDetails |
| 403.description | "Catalog read scope or resource policy refused the request" |
| 404.content.application/problem+json.schema | ProblemDetails |
| 404.description | "Catalog item was not found for the authenticated tenant" |
#Дополнительные условия
| Поле | Значение |
|---|
| operationId | "getCatalogItem" |
| tags | ["catalog"] |
| x-idempotency | "none" |