添加开放能力 #

描述 #

使用此接口添加开放能力。

接口说明 #

授权对象 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": "元/天/人"
    }
  }
}
上次更新: 9/26/2024, 10:51:34 PM