获取开放能力列表 #

描述 #

使用此接口获取获取开放能力列表,用于选取能力、添加能力。

接口说明 #

授权对象 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
  }
}
上次更新: 10/18/2024, 1:00:57 PM