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

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

getExternalContentDraft

Обновлено

GET /api/v1/tools/external-content-publish/{draftHandle}

Read the full draft lifecycle and finalized media

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

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

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

ПолеЗначение
0.in"path"
0.name"draftHandle"
0.requiredtrue
0.schema0.schema

Тело запроса

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

Ответы

ПолеЗначение
200.content.application/json.schemaExternalContentDraft
200.description"Full current draft projection"
200.headers.X-Bot-Username.description"Active public 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 budget or unknown"
200.headers.X-RateLimit-Remaining.schema200.headers.X-RateLimit-Remaining.schema
200.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
200.headers.X-RateLimit-Reset.schema200.headers.X-RateLimit-Reset.schema

Ошибки

ПолеЗначение
400.content.application/problem+json.schemaProblemDetails
400.description"Invalid draft input"
400.headers.X-Bot-Username.description"Active public bot username, when resolved"
400.headers.X-Bot-Username.schema400.headers.X-Bot-Username.schema
400.headers.X-Client-Slug.description"Active tenant slug, when resolved"
400.headers.X-Client-Slug.schema400.headers.X-Client-Slug.schema
400.headers.X-RateLimit-Limit.description"Effective request budget"
400.headers.X-RateLimit-Limit.schema400.headers.X-RateLimit-Limit.schema
400.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
400.headers.X-RateLimit-Remaining.schema400.headers.X-RateLimit-Remaining.schema
400.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
400.headers.X-RateLimit-Reset.schema400.headers.X-RateLimit-Reset.schema
401.content.application/problem+json.schemaProblemDetails
401.description"Missing or invalid credential"
401.headers.X-Bot-Username.description"Active public bot username, when resolved"
401.headers.X-Bot-Username.schema401.headers.X-Bot-Username.schema
401.headers.X-Client-Slug.description"Active tenant slug, when resolved"
401.headers.X-Client-Slug.schema401.headers.X-Client-Slug.schema
401.headers.X-RateLimit-Limit.description"Effective request budget"
401.headers.X-RateLimit-Limit.schema401.headers.X-RateLimit-Limit.schema
401.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
401.headers.X-RateLimit-Remaining.schema401.headers.X-RateLimit-Remaining.schema
401.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
401.headers.X-RateLimit-Reset.schema401.headers.X-RateLimit-Reset.schema
403.content.application/problem+json.schemaProblemDetails
403.description"Required content:read scope or resource policy refused"
403.headers.X-Bot-Username.description"Active public bot username, when resolved"
403.headers.X-Bot-Username.schema403.headers.X-Bot-Username.schema
403.headers.X-Client-Slug.description"Active tenant slug, when resolved"
403.headers.X-Client-Slug.schema403.headers.X-Client-Slug.schema
403.headers.X-RateLimit-Limit.description"Effective request budget"
403.headers.X-RateLimit-Limit.schema403.headers.X-RateLimit-Limit.schema
403.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
403.headers.X-RateLimit-Remaining.schema403.headers.X-RateLimit-Remaining.schema
403.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
403.headers.X-RateLimit-Reset.schema403.headers.X-RateLimit-Reset.schema
404.content.application/problem+json.schemaProblemDetails
404.description"Draft is absent or belongs to another tenant"
404.headers.X-Bot-Username.description"Active public bot username, when resolved"
404.headers.X-Bot-Username.schema404.headers.X-Bot-Username.schema
404.headers.X-Client-Slug.description"Active tenant slug, when resolved"
404.headers.X-Client-Slug.schema404.headers.X-Client-Slug.schema
404.headers.X-RateLimit-Limit.description"Effective request budget"
404.headers.X-RateLimit-Limit.schema404.headers.X-RateLimit-Limit.schema
404.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
404.headers.X-RateLimit-Remaining.schema404.headers.X-RateLimit-Remaining.schema
404.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
404.headers.X-RateLimit-Reset.schema404.headers.X-RateLimit-Reset.schema
429.content.application/problem+json.schemaProblemDetails
429.description"Request budget exhausted"
429.headers.Retry-After.description"Retry delay in seconds when supplied by the limiter"
429.headers.Retry-After.schema429.headers.Retry-After.schema
429.headers.X-Bot-Username.description"Active public bot username, when resolved"
429.headers.X-Bot-Username.schema429.headers.X-Bot-Username.schema
429.headers.X-Client-Slug.description"Active tenant slug, when resolved"
429.headers.X-Client-Slug.schema429.headers.X-Client-Slug.schema
429.headers.X-RateLimit-Limit.description"Effective request budget"
429.headers.X-RateLimit-Limit.schema429.headers.X-RateLimit-Limit.schema
429.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
429.headers.X-RateLimit-Remaining.schema429.headers.X-RateLimit-Remaining.schema
429.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
429.headers.X-RateLimit-Reset.schema429.headers.X-RateLimit-Reset.schema

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

ПолеЗначение
description"Compound tenant and opaque draftHandle lookup; seqNum is null until entity correlation. publishedMessageIds are Telegram message coordinates, not entity PKs. mediaRefs are immutable finalized descriptors, never source/signed media URLs. A single draft has no pagination or idempotency requirement. Authentication is X-Api-Key OR Bearer tgf_* secrets; surface-session JWTs are refused. Writes use POST /content/publish."
operationId"getExternalContentDraft"
summary"Read the full draft lifecycle and finalized media"
tags["content"]
x-scope-semantics"ALL"