SuperAPI AI 工具集

discover-portal-apis

智能体与模型

查看项目

更新于 10-16 06:49

技能介绍

用途:该技能用于 API Experience Hub(AEH)门户的发现环节。作为门户消费者(终端用户),用户可先浏览和检索门户发布的资产,再查看某个资产的详细信息、使用条款与文档,从而决定申请访问哪个 API。

前置条件:需具备有效的门户消费者 Bearer token,已加入该门户;并了解目标上下文,即 targetOrganizationId(托管门户的 Anypoint 组织 ID)和 portalId / targetPortalId(所浏览的门户 ID)。

主要能力与操作(api 均为 urn:api:api-experience-hub-consumer):

  1. listAssetsCommunityAsset:列出门户发布的全部资产,返回 assets、groupId、assetId、minorVersion。
  2. searchCommunityAssets:按关键词、标签、分类或资产类型筛选,支持 searchTerm、tags、limit、offset 等条件,返回匹配资产。
  3. getAssetDetails:用 groupId、assetId、minorVersion 获取单个资产的完整元数据,含摘要、描述、联系信息、分类器、可见的次要版本及可申请的实例与层级。
  4. getTermsAndConditions:读取该资产发布的条款内容(content)。
  5. getAssetPages:获取资产发布的文档页面,可选 pagePath 指定单个页面,留空则列出全部页面。
  6. getAssetResource:可选,用资产详情返回的 resourceId 下载附带资源(如图表、示例文件、SDK 包)。

使用方式:按“浏览目录—关键词搜索—打开资产详情—阅读条款—查阅文档—按需下载资源”的顺序依次调用上述操作;各操作的 targetOrganizationId、targetPortalId 来自已知上下文,groupId、assetId、minorVersion 来源于前一步输出。完成后即可获得决定申请哪个 API 所需的元数据、条款和文档。

适用场景:门户消费者需要发现并评估已发布 API、在申请访问前了解条款与文档时使用。

限制:资料仅说明操作输入与输出,未提供具体接口地址、请求方法、错误处理、权限范围、定价或计费信息;使用前需具备有效令牌与门户成员身份。相关后续任务包括 request-api-access(为选定实例与层级创建合同)和 manage-portal-applications(管理持有 API 凭据的应用)。