title: 获取保单列表

获取保单列表

描述

使用此接口获取/查询保单列表信息。

接口说明

授权对象 APP

请求地址 GET /open/insurance/orderList

请求规则 请查阅开发必读

请求参数

参数名称 变量名称 参数类型[长度限制] 是否必填 描述
页码数 page uint32 query页码从1开始计数,若不填则默认为1。

示例值:1

每页记录数 limit uint32 query每一页返回的记录条数,请勿多次使用过大数值,推荐30以内,若多次请求过大数值将会被拉入黑名单一定时间,若不填则默认为10。

示例值:10

搜索关键词 keyword string[1, 32] query支持通过真实姓名、身份证号、关联订单号、保单号、开放平台订单号精确搜索。

示例值:布尔

开始时间 startAt int64 query保险订单下单时间范围。

示例值:1626537600

结束时间 endAt int64 query保险订单下单时间范围。

示例值:1626616800

请求示例

{
  "page": 1,
  "limit": 10,
  "keyword": "布尔",
  "startAt": 1626537600,
  "endAt": 1626537600
}

响应结果

参数名称 变量名称 参数类型[长度限制] 是否必填 描述
保单列表 list object
总记录数 total int64

保单列表 list

参数名称 变量名称 参数类型[长度限制] 是否必填 描述
关联订单号 orderNumber string[1, 32] 此数据为投保方关联的业务订单号。

示例值:202107188491437550138214

平台订单号 transactionId string[1, 32] 此数据为开放平台的订单号,在平台为唯一订单号信息。

示例值:202107187462757791703647

保险单号 insuranceId string[1, 32] 此数据为保险公司的订单号,在保险公司为唯一订单号信息。

示例值:202107188168316148713525

保险费用 price float64

示例值:3.8

真实姓名 realName string[1, 16]

示例值:布尔

身份证号 idCard string[1, 32]

示例值:520888201712088888

手机号码 mobile string[1, 32]

示例值:13024777828

下单时间 createdAt int64 保险下单时间。

示例值:1626610000

生效时间 insuranceStartAt int64 保险开始承保时间。

示例值:1626610000

保单时间 insuranceEndAt int64 保险有效时间截至。

示例值:1626623999

备注 remark string[1, 64] 订单备注

响应示例

> 200 Response
{
  "code": 20000,
  "msg": "success",
  "data": {
    "list": [
      {
        "orderNumber": "202107188491437550138214",
        "transactionId": "202107187462757791703647",
        "insuranceId": "202107188168316148713525",
        "price": 3.8,
        "createdAt": 1626610000,
        "insuranceStartAt": 1626610000,
        "insuranceEndAt": 1626623999,
        "idCard": "520888201712088888",
        "mobile": "13024777828",
        "realName": "布尔"
      }
    ],
    "total": 1
  }
}