开放应用签约/续签能力 #
描述 #
使用此接口为开放应用签约/续签能力。
接口说明 #
授权对象 APP
请求地址 PUT /open/app/ability
请求规则 请查阅开发必读
请求参数 #
| 参数名称 | 变量名称 | 参数类型[长度限制] | 是否必填 | 描述 |
|---|---|---|---|---|
| 能力ID | id | uint32 | 是 | 此参数为能力的唯一标识。 示例值：1 |
响应结果 #
| 参数名称 | 变量名称 | 参数类型[长度限制] | 是否必填 | 描述 |
|---|---|---|---|---|
| 能力信息 | ability | object | 是 |
能力信息 ability #
| 参数名称 | 变量名称 | 参数类型[长度限制] | 是否必填 | 描述 |
|---|---|---|---|---|
| 能力ID | id | uint32 | 是 | 此参数为能力的唯一标识。 示例值：1 |
| 能力名称 | title | string[1, 32] | 是 | 示例值：骑手保险 |
| 能力类别 | code | int8 | 是 | 此参数为能力的类别标识。1 保险业务 示例值：1 |
| 能力状态 | status | int8 | 是 | 1 待签约 2 签约中 3 已生效 4 签约失败 5 已失效。 示例值：2 |
| 签约单价 | 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": "元/天/人"
}
}
}