К содержанию
TelegaFirst

Для AI-агентов: markdown этой страницы — /docs/api-op-listsitepages.mdиндекс документации — /llms.txt

listSitePages

Обновлено

GET /api/v1/tools/site/pages

List publishable hosts and registered site pages

Авторизация и права

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["site:read"]

Параметры запроса

ПолеЗначение
Параметры[]

Тело запроса

ПолеЗначение
Тело запросаnull

Ответы

ПолеЗначение
200.content.application/json.schemaSitePageList
200.description"Tenant site control-plane result"
200.headers.X-Bot-Username.description"Active bot username, when resolved"
200.headers.X-Bot-Username.schema200.headers.X-Bot-Username.schema
200.headers.X-Client-Slug.description"Active tenant slug, when resolved"
200.headers.X-Client-Slug.schema200.headers.X-Client-Slug.schema
200.headers.X-RateLimit-Limit.description"Effective request budget"
200.headers.X-RateLimit-Limit.schema200.headers.X-RateLimit-Limit.schema
200.headers.X-RateLimit-Remaining.description"Remaining request budget"
200.headers.X-RateLimit-Remaining.schema200.headers.X-RateLimit-Remaining.schema
200.headers.X-RateLimit-Reset.description"Unix window reset in seconds"
200.headers.X-RateLimit-Reset.schema200.headers.X-RateLimit-Reset.schema

Ошибки

ПолеЗначение
401.content.application/problem+json.schemaProblemDetails
401.description"Missing, invalid, revoked or conflicting credential; surface JWT is refused"
401.x-error-codes["INVALID_API_KEY"]
403.content.application/problem+json.schemaProblemDetails
403.description"Missing scope, prohibited publishable credential or absent active bot"
403.x-error-codes["INSUFFICIENT_SCOPE","PUBLISHABLE_KEY_NOT_ALLOWED","NO_ACTIVE_BOT"]
413.content.application/problem+json.schemaProblemDetails
413.description"Resource policy size or item-count limit exceeded"
413.x-error-codes["PAYLOAD_TOO_LARGE","ITEM_COUNT_EXCEEDED"]
429.content.application/problem+json.schemaProblemDetails
429.description"Resource rate budget exceeded or unavailable"
429.headers.Retry-After.description"Retry delay in seconds, when supplied by the limiter"
429.headers.Retry-After.schema429.headers.Retry-After.schema
429.x-error-codes["RATE_LIMIT_EXCEEDED","RATE_LIMIT_UNAVAILABLE"]
500.content.application/problem+json.schemaProblemDetails
500.description"Unexpected internal failure"
500.x-error-codes["INTERNAL_ERROR"]

Дополнительные условия

ПолеЗначение
description"site:read. `hosts` is every host the publication routes accept: the platform site address and each custom domain (live once verified). `pages` is every page ever published, addressed by its tenant seq_num; public_url is null while the page is not served and reason says why. mini_app_links (per page) and mini_app_home (no parameter) open the page or the home AS the Telegram / MAX / VK mini app — paste them into a broadcast text; a channel whose link would not open the mini app gets url null and a reason. Protected platform pages cannot be hidden or deleted one by one."
operationId"listSitePages"
summary"List publishable hosts and registered site pages"
tags["site"]
x-idempotency.conflictStatusnull
x-idempotency.implementation"none"
x-idempotency.replayStatusnull
x-idempotency.requiredfalse
x-idempotency.scope[]
x-idempotency.ttlSecondsnull
x-pagination.queryParameters[]
x-pagination.supportedfalse
x-scope-semantics"ALL"