跳转到正文
PowersOpenAPI

Describe host protocols and configured capabilities

GET/api/powers/v1/host

Describe host protocols and configured capabilities 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

参数

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
Authenticated host capability description; no secret references or credentials
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
Invocation pending, changed idempotency envelope, revision mismatch or scope 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 关闭