title: 获取开放能力

获取开放能力列表

描述

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

接口说明

授权对象 ISVAPP

请求地址 GET /open/app/abilityList

请求规则 请查阅开发必读

请求参数

参数名称 变量名称 参数类型[长度限制] 是否必填 描述
页码数 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

能力状态 status int8 0 待添加 1 待签约 2 签约中 3 已生效 4 签约失败 5 已失效。

示例值:0

签约单价 price float64 若暂时没有价格或免费情况下不返回此数据值。

示例值:3.8

价格单位 unit string[1, 32] 若暂时没有价格或免费情况下不返回此数据值。

示例值:元/天/人

签约说明 message string[1, 255] 此参数是本能力的签约说明,如被驳回的信息、签约能力的问题。

示例值:您的签约请求被驳回,原因:营业执照不清晰。

响应示例

> 200 Response
{
  "code": 20000,
  "msg": "success",
  "data": {
    "list": [
      {
        "code": 1
        "desc": "由中国平安保险承保的雇主责任保险(A款),不保机动车第三方责任。"
        "id": 1
        "price": 3.5
        "status": 2
        "title": "骑手保险(中国平安上海分公司)"
        "unit": "元/天/人"
      }
    ],
    "total": 1
  }
}