添加开放能力 #
描述 #
使用此接口添加开放能力。
接口说明 #
授权对象 ISVAPP
请求地址 POST /open/app/ability
请求规则 请查阅开发必读
请求参数 #
参数名称 | 变量名称 | 参数类型[长度限制] | 是否必填 | 描述 |
---|---|---|---|---|
AppID | appId | string[1, 32] | 条件选填 | query此参数为应用唯一标识,若授权对象为ISV 则此项必填,若授权对象为APP 则此项不校验且以HTTP Header 内信息为准。示例值:Zc3SsV49OHVG0uB9 |
能力ID | id | uint32 | 是 | 此参数为能力的唯一标识。 示例值:1 |
请求示例 #
{
"id": 1
}
响应结果 #
参数名称 | 变量名称 | 参数类型[长度限制] | 是否必填 | 描述 |
---|---|---|---|---|
能力信息 | ability | object | 是 |
能力信息 ability #
参数名称 | 变量名称 | 参数类型[长度限制] | 是否必填 | 描述 |
---|---|---|---|---|
能力ID | id | uint32 | 是 | 此参数为能力的唯一标识。 示例值:1 |
能力名称 | title | string[1, 32] | 是 | 示例值:骑手保险 |
能力类别 | code | int8 | 是 | 此参数为能力的类别标识。1 保险业务 示例值:1 |
能力状态 | status | int8 | 是 | 1 待签约 2 签约中 3 已生效 4 签约失败 5 已失效。 示例值:3 |
签约单价 | price | float64 | 否 | 若暂时没有价格或免费情况下不返回此数据值。 示例值:3.8 |
价格单位 | unit | string[1, 32] | 否 | 若暂时没有价格或免费情况下不返回此数据值。 示例值:元/天/人 |
签约说明 | message | string[1, 255] | 是 | 此参数是本能力的签约说明,如被驳回的信息、签约能力的问题。 示例值:您的签约请求被驳回,原因:营业执照不清晰。 |
响应示例 #
> 200 Response
{
"code": 20000,
"msg": "success",
"data": {
"ability": {
"id": 1,
"code": 1,
"desc": "由中国平安保险承保的雇主责任保险(A款)。此能力签约生效后可为骑手投保,每日22点前确认名单次日0点自动生效投保。",
"message": "",
"price": 3.8,
"status": 1,
"title": "骑手保险",
"unit": "元/天/人"
}
}
}