Cloud REST API 参考

先确认访问范围

第三方开发不需要管理员权限。管理接口用于内部运营角色，包含审核、定价和付款等操作。

目录与版本

• GET按分类查询扩展/api/marketplace/category/{category}→
• GET浏览扩展目录/api/marketplace/plugins→
• GET最新扩展/api/marketplace/plugins/latest→
• GET热门扩展/api/marketplace/plugins/popular→
• GET推荐扩展/api/marketplace/plugins/recommended→
• GET搜索扩展/api/marketplace/plugins/search→
• GET精选扩展/api/marketplace/plugins/staff-picks→
• GET趋势扩展/api/marketplace/plugins/trending→
• GET读取扩展详情/api/marketplace/plugins/{id}→
• GET解析兼容版本/api/marketplace/plugins/{id}/resolve→
• GET查询扩展版本/api/marketplace/plugins/{id}/versions→
• GET读取指定版本/api/marketplace/plugins/{id}/versions/{version}→
• POST记录扩展浏览/api/marketplace/plugins/{id}/view→
• GET读取签名信任元数据/api/marketplace/trust-metadata→

用户与安装

• GET查询结账状态/api/marketplace/checkout/{order_id}→
• GET查询扩展权益/api/marketplace/entitlements→
• GET读取安装记录/api/marketplace/installed→
• POST记录已安装版本/api/marketplace/installed/{id}→
• DELETE移除安装记录/api/marketplace/installed/{id}→
• GET取得授权下载地址/api/marketplace/plugins/{id}/artifact-url→
• POST创建结账会话/api/marketplace/plugins/{id}/checkout→
• POST记录下载次数/api/marketplace/plugins/{id}/download→
• GET查看扩展评价/api/marketplace/plugins/{id}/reviews→
• POST提交评价/api/marketplace/plugins/{id}/reviews→
• GET查询订阅/api/marketplace/subscriptions→
• POST取消订阅/api/marketplace/subscriptions/{id}/cancel→
• GET读取订阅收据/api/marketplace/subscriptions/{id}/receipts→

发布者

先阅读发布指南。当服务关闭发布入口时，会返回 marketplace_publishing_disabled。

• POST中止包上传/api/marketplace/plugins/submissions/abort→
• POST完成包提交/api/marketplace/plugins/submissions/complete→
• POST申请包上传凭证/api/marketplace/plugins/submissions/upload-ticket→
• POST以 Base64 提交包/api/marketplace/plugins/submit→
• GET查看我的提交/api/marketplace/publisher/me/submissions→
• POST登记发布者公钥/api/marketplace/publisher/register→
• GET查询发布者信息/api/marketplace/publisher/{author}→
• GET查询发布者的扩展/api/marketplace/publisher/{author}/plugins→

创作者收益

这些接口涉及收款接入与结算，适合已经完成发布者接入的创作者。

• POST绑定创作者账户/api/marketplace/creator/account→
• GET查询收款接入配置/api/marketplace/creator/connect/config→
• POST创建收款接入链接/api/marketplace/creator/connect/link→
• POST创建收款开户流程/api/marketplace/creator/connect/onboarding→
• GET刷新收款接入回调/api/marketplace/creator/connect/refresh/{token}→
• GET收款接入返回页面/api/marketplace/creator/connect/return/{token}→
• GET查询收款接入状态/api/marketplace/creator/connect/status→
• POST同步收款接入状态/api/marketplace/creator/connect/sync→
• GET查询付款记录/api/marketplace/creator/payouts→
• POST同步付款记录/api/marketplace/creator/payouts/sync→
• GET查询付款对账详情/api/marketplace/creator/payouts/{payout_id}/reconciliation→
• POST同步付款对账/api/marketplace/creator/payouts/{payout_id}/reconciliation→
• GET读取对账事实/api/marketplace/creator/payouts/{payout_id}/reconciliation/facts/{fact_id}→
• GET查询对账历史/api/marketplace/creator/payouts/{payout_id}/reconciliation/history→
• GET查询创作者结算汇总/api/marketplace/creator/summary→
• POST申请创作者提现/api/marketplace/creator/withdrawals→