SuperAPI AI 工具集

portaly-overview

编程与开发

查看项目

更新于 10-16 03:44

技能介绍

用途:这是面向 Portaly 开放 API 的导览与导航技能,帮助用户或其智能体先弄明白能做什么、该用哪个技能,再转交到具体实现技能。它自身不创建结账会话、不签名回调、不调用任何 API。

主要能力:概览开放 API 范围,包括订阅支付(月付/年付、一次性与动态定价、托管结账、续订回调、取消/恢复、订阅者自助门户)、折扣码、数字商品(单品或自定义组合结账、托管支付与邮件、签名 webhook)、订单与发票查询、买家推广(仅限台湾地区账户)、邮件(仅限邀请制测试版)、评论组件(托管 iframe,无需 API 密钥)。支付、商品、推广共用同一 API 密钥前缀(pcs_live_* / pcs_test_);邮件使用独立密钥(pem_),两类密钥不能互用。

使用方式:先询问用户要构建什么,对照能力映射表指向对应技能;安装命令按技能区分,例如订阅相关工作流使用 npx skills add portaly-ai/portaly-skills --skill portaly-payment,数字商品用 portaly-product,评论用 portaly-review,推广用 portaly-affiliate,邮件用 portaly-email。完整接口清单建议实时获取 https://portaly.ai/llms.txt 或 https://portaly.ai/openapi.json,权威文档为 https://portaly.ai/docs。用户若尚无账户或密钥,可在 https://portaly.cc/payment 注册、在 https://portaly.cc/admin/creator-subscription 创建 API 密钥。

限制:本技能仅做导航,不重复 portaly-payment 或 portaly-product 的实现步骤;不得指向仅管理员可用的接口或内部仪表盘 API;文档与本技能冲突时以文档为准;不要虚构接口,映射表未覆盖的能力应说明其不属于当前开放 API。此外,若环境变量中已存在 PORTALY_API_KEY,会话内会向 Portaly 发送一次非阻塞的版本上报(POST /api/creator-subscription/skill-version,请求体仅含技能名与版本),失败可忽略;缺少密钥则跳过。