用途:该技能用于 API Experience Hub(AEH)门户的发现环节。作为门户消费者(终端用户),用户可先浏览和检索门户发布的资产,再查看某个资产的详细信息、使用条款与文档,从而决定申请访问哪个 API。
前置条件:需具备有效的门户消费者 Bearer token,已加入该门户;并了解目标上下文,即 targetOrganizationId(托管门户的 Anypoint 组织 ID)和 portalId / targetPortalId(所浏览的门户 ID)。
主要能力与操作(api 均为 urn:api:api-experience-hub-consumer):
- listAssetsCommunityAsset:列出门户发布的全部资产,返回 assets、groupId、assetId、minorVersion。
- searchCommunityAssets:按关键词、标签、分类或资产类型筛选,支持 searchTerm、tags、limit、offset 等条件,返回匹配资产。
- getAssetDetails:用 groupId、assetId、minorVersion 获取单个资产的完整元数据,含摘要、描述、联系信息、分类器、可见的次要版本及可申请的实例与层级。
- getTermsAndConditions:读取该资产发布的条款内容(content)。
- getAssetPages:获取资产发布的文档页面,可选 pagePath 指定单个页面,留空则列出全部页面。
- getAssetResource:可选,用资产详情返回的 resourceId 下载附带资源(如图表、示例文件、SDK 包)。
使用方式:按“浏览目录—关键词搜索—打开资产详情—阅读条款—查阅文档—按需下载资源”的顺序依次调用上述操作;各操作的 targetOrganizationId、targetPortalId 来自已知上下文,groupId、assetId、minorVersion 来源于前一步输出。完成后即可获得决定申请哪个 API 所需的元数据、条款和文档。
适用场景:门户消费者需要发现并评估已发布 API、在申请访问前了解条款与文档时使用。
限制:资料仅说明操作输入与输出,未提供具体接口地址、请求方法、错误处理、权限范围、定价或计费信息;使用前需具备有效令牌与门户成员身份。相关后续任务包括 request-api-access(为选定实例与层级创建合同)和 manage-portal-applications(管理持有 API 凭据的应用)。