OpenMax
免费试用

Apps API · Artifacts

Artifacts: 1 个接口

← 全部分组

POST /api/v1/artifacts/resolve

Resolve artifact URIs

权限(scope): kb:artifact:read · 调用方式: appToken · operationId: resolve-uris

Required app scope: kb:artifact:read.

Batch-resolve artifact:// URIs to presigned download URLs. Use inline=false for download disposition. A URI is resolved only when the caller may read its artifact: a conversation file requires that the caller uploaded it or can read a conversation it was shared in; a knowledge-base file requires that the caller can read a node that holds it (a private knowledge base only for its owner and the owner's Agents, a restricted Default knowledge-base node only for those it admits). Either domain admitting the caller is enough; an artifact neither domain manages keeps the organization check. Any other URI (unreadable conversation or knowledge-base file, malformed URI, an artifact ID that is not a UUID, or a file name with an empty, "." or ".." segment, a backslash or a control character, another organization's artifact, or a caller without a member identity) is listed in failed, and no URL is issued for it; failed is de-duplicated and keeps the request order. When read access cannot be verified the whole request fails with 503 ARTIFACT_ACCESS_UNAVAILABLE and nothing is signed. When download tickets are enabled, download_url is a short-lived platform URL (download-artifact-ticket) instead of a storage URL and expires_at is the ticket expiry: single-use for inline=false, reusable until expiry for inline=true; access is re-checked when it is opened. Response wrapped in standard envelope.

请求体

application/json · ResolveURIsRequestBody

字段 类型 必填 说明
inline boolean If true, return inline content-disposition URLs
uris array of string 是 List of artifact:// URIs to resolve

回包