SuperAPI AI 工具集

request-api-access

编程与开发

查看项目

更新于 10-16 01:31

技能介绍

用途:在 API Experience Hub(AEH)门户中,以消费方身份申请已发布 API 的访问权限。AEH 中的“访问”通过合同(contract)实现,合同把某个应用与特定 API 实例(如 sandbox/production)及所选 SLA 层级绑定。本流程覆盖从发现层级与授权类型,到创建合同、列出合同、调整层级的完整消费侧操作。

主要能力:列出实例可用的 SLA 层级(getTiers);列出 API 实例提供的授权类型(getGrantTypesByInstanceId);列出应用支持的授权类型(getGrantTypesByApplicationId);创建合同(createContract);按应用列出合同(getContractsByApplicationId);获取合同详情(getContract);更改活动合同的 SLA 层级(assignSlaTierToContract)。创建前需确认应用与实例之间至少有一种授权类型重叠。合同可能为 APPROVED 或 PENDING,需管理员审批时保持 PENDING。

必要用法:需准备有效的门户消费方 Bearer token、门户成员资格、targetOrganizationId、portalId、已存在的 applicationId,以及目标资产坐标 groupId、assetId、minorVersion、instanceId。所有调用使用 api: urn:api:api-experience-hub-consumer。创建合同时传入 contractRequest(applicationId、tierId、acceptedTerms 等),返回合同 ID 与状态。调整层级时传入新 tierId,可能立即生效或需审批。

适用场景:需要为应用申请 API 访问、审计应用已有合同、在用量增长时升降 SLA 层级。

限制:需具备相应门户权限与上下文;tier 是否为必选取决于实例配置;合同状态与层级变更生效方式受门户策略影响。具体授权范围、错误码与审批规则暂未提供。