获取开放能力列表 #
描述 #
使用此接口获取获取开放能力列表,用于选取能力、添加能力。
接口说明 #
授权对象 ISVAPP
请求地址 GET /open/app/abilityList
请求规则 请查阅开发必读
请求参数 #
参数名称 | 变量名称 | 参数类型[长度限制] | 是否必填 | 描述 |
---|---|---|---|---|
AppID | appId | string[1, 32] | 条件选填 | query此参数为应用唯一标识,若授权对象为ISV 则此项必填,若授权对象为APP 则此项不校验且以HTTP Header 内信息为准。示例值:Zc3SsV49OHVG0uB9 |
页码数 | page | uint32 | 否 | query页码从1开始计数,若不填则默认为1。 示例值:1 |
每页记录数 | limit | uint32 | 否 | query每一页返回的记录条数,请勿多次使用过大数值,推荐30以内,若多次请求过大数值将会被拉入黑名单一定时间,若不填则默认为10。 示例值:10 |
请求示例 #
{
"page": 1,
"limit": 10
}
响应结果 #
参数名称 | 变量名称 | 参数类型[长度限制] | 是否必填 | 描述 |
---|---|---|---|---|
能力列表 | list | []object | 否 |
能力列表 list #
参数名称 | 变量名称 | 参数类型[长度限制] | 是否必填 | 描述 |
---|---|---|---|---|
能力ID | id | uint32 | 是 | 此参数为能力的唯一标识。 示例值:1 |
能力名称 | title | string[1, 32] | 是 | 示例值:骑手保险 |
能力介绍 | desc | text | 是 | 此参数为能力的概要说明,类型为富文本。 |
能力类别 | code | int8 | 是 | 此参数为能力的类别标识。1 保险业务 示例值:1 |
能力状态 | status | int8 | 是 | 0 待添加 1 待签约 2 签约中 3 已生效 4 签约失败 5 已失效。 示例值:0 |
签约单价 | price | float64 | 否 | 若暂时没有价格或免费情况下不返回此数据值。 示例值:3.8 |
价格单位 | unit | string[1, 32] | 否 | 若暂时没有价格或免费情况下不返回此数据值。 示例值:元/天/人 |
签约说明 | message | string[1, 255] | 是 | 此参数是本能力的签约说明,如被驳回的信息、签约能力的问题。 示例值:您的签约请求被驳回,原因:营业执照不清晰。 |
能力类别枚举类 #
能力名称 | 能力标识 | 字符串标识 | 是否开放 |
---|---|---|---|
保险业务 | 1 | Insurance | 否 |
响应示例 #
> 200 Response
{
"code": 20000,
"msg": "success",
"data": {
"list": [
{
"id": 1,
"code": 1,
"desc": "由中国平安保险承保的雇主责任保险(A款),不保机动车第三方责任。",
"id": 1,
"price": 3.5,
"status": 2,
"title": "骑手保险(中国平安上海分公司)",
"unit": "元/天/人",
}
],
"total": 1
}
}