跳转到正文
PowersOpenAPI

List catalog services

GET/api/powers/v1/services

The same authorized catalog list as /v1/providers, projected as services and serviceId. Both names share ordering, revision and cursors; use the corresponding serviceId or providerId filter with the same value. Authenticate with an organization API key. Native permission names describe runtime capabilities; x-sinecloud-scopes lists the customer key scopes required by Cloud.

组织 API Key 鉴权

Authorization: Bearer $SINECLOUD_API_KEY

所需权限: catalogRead

参数

serviceId · query · 可选
limit · query · 可选
cursor · query · 可选
Opaque base64url cursor returned in pagination.nextCursor. It is bound to the catalog revision and query; do not interpret or synthesize it.
X-Sinecloud-Project-Id · header · 可选
Select a currently accessible project. A project-restricted key cannot select another project. Omit to use the key restriction or organization scope as permitted.

响应

200
Service page
400
Invalid request
401
Bearer authentication required
402
Insufficient wallet balance or execution budget.
403
Request is not authorized
405
Method not allowed; inspect Allow
409
Catalog cursor, Endpoint revision, idempotency, or run state conflict
429
Request rate or quota exceeded. Respect Retry-After when supplied.
500
Internal error; details are not disclosed
502
Runtime response unavailable. Reuse the original Idempotency-Key and request envelope to recover the admitted invocation.
503
Runtime unavailable

正在加载 API 参考文档…

Powers · 接入与鉴权

基础 URLhttps://sinecloud.dev/api/powers/v1

首次调用前

在控制台选择组织、准备资源,并创建具有所需产品权限范围的组织 API Key。每次调用都会检查当前权限、资源访问权限、预算和可用资金。

选择可用端点,检查当前版本和输入结构。接口目录涵盖端点发现、组织连接、工具执行和持久化任务恢复。托管执行包含 endpointId、expectedEndpointRevision 和 input;原生执行还需选择组织拥有的连接,也可显式指定绑定。请保留原生结果及状态格式。

使用各接口 x-sinecloud-scopes 列出的 Cloud 权限,原生权限名称描述运行时能力。修改连接需要 connectionWrite 和未限制项目的组织级密钥;BYOK 凭据在控制台添加。恢复结果不明确的调用时,请重用原始 Idempotency-Key、版本和完整输入。HTTP 成功并不代表任务执行成功。

组织密钥鉴权与基础 URL

产品 API 的生产源地址是 https://sinecloud.dev,不是文档站点。路径前缀为 /api/powers/v1。请使用接口注明的完整路径,并将资源 ID、模型与端点版本替换为实际值。

Authorization: Bearer $SINECLOUD_API_KEY

将 SINECLOUD_API_KEY 设置为你自己的环境变量值,切勿使用平台服务凭据。各接口的 x-sinecloud-scopes 会注明所需的权限范围。

此文档为只读参考,请在控制台或自己的客户端中发起请求。浏览文档不会创建密钥、启动执行或产生执行费用。请保留请求 ID 和执行回执;连接中断不会取消任务,再次提交前请按接口说明恢复并确认状态。

控制台

输入关键词开始搜索…

↑↓ 移动↵ 选择Esc 关闭