申请Apikey
接口说明
用户购买商品并付款成功,云商店将调用本接口通知商家创建实例,商家需要结合MaaS model应用的实际情况,给用户开通MaaS model服务。
功能介绍
客户在华为云订阅三方模型后,云商店调用伙伴接口申请Apikey,用于MaaS和伙伴之间的鉴权依据。该接口是同步调用,如果伙伴接口调用失败,客户在华为云侧将订阅失败。
调用路径:华为 云商店-> 伙伴。
约束:针对同一个伙伴的不同模型,只会在客户首次订阅的时候,云商店调用伙伴接口申请Apikey;客户订阅其他模型,不会再调用伙伴接口申请Apikey,MaaS会用相同的Apikey访问伙伴模型服务
请求参数
POST方法
表1-1 请求URL PATH参数
| 参数 | 是否必选 | 参数类型 | 描述 |
| signature | 是 | String | 加密签名,通过一定的规则对请求进行签名产生的值 |
| timestamp | 是 | Long | UNIX 时间戳(单位毫秒), 商家需要校验这个时间戳与当前时间相差不超过60s |
| nonce | 是 | String | 随机字符串,云商店在每次调用时会随机生成,商家可以通过对这个随机数的缓存来防御API重放攻击。 |
表1-2 请求Body参数
| 参数 | 是否必选 | 参数类型 | 描述 |
| activity | 是 | String | 接口请求标识,用于区分接口请求场景。 申请场景取值:applyApikey |
| chargingMode | 是 | String | 计费模式。 ON_DEMAND:按需计费 |
| customerId | 是 | String | 客户ID |
| customerName | 是 | String | 客户账号名, 可以修改,不建议作为唯一标识 |
| testFlag | 否 | String | 取值为1表示调试请求,帮助伙伴在云商店先进行接口调试,然后再正式对外提供服务 |
响应参数
状态码:200
表1-3 响应Body参数
| 参数 | 参数类型 | 描述 |
| resultCode | String | 结果码,成功返回000000 |
| resultMsg | String | 结果描述 |
| Apikey | String | 模型访问Apikey |
状态码
| 状态码 | 描述 |
| 200 | 接口响应成功 |
错误码
| 模块 | 结果码 | 结果码说明 |
|---|---|---|
| 公共 | 000000 | 成功 |
| 000001 | 鉴权失败 | |
| 000002 | 请求参数不合法 | |
| 000003 | 实例ID不存在(商品续费、过期、资源释放接口可能返回) | |
| 000004 | 请求处理中 | |
| 000005 | 其它服务内部错误 | |
| 创建实例 | 000100 | 无可用实例资源分配 |
| 000101 | Mobile number not specified or already exists//手机号为空或重复 | |
| 000102 | Email address is not specified or already exists//邮箱号为空或重复 | |
| 000103 | Product already purchased//该商品不可重复购买 | |
| 000104 | Internal service error//该商品内部服务异常 | |
| 000105 | Account has already subscribed to benefits//该账号已购买权益,无法再开通 | |
| 000106 | Product resources sold out.//该商品资源已售罄 | |
| 000107 | SaaS email domain already exists.//该SaaS邮箱域名重复 |