文档
测试

个人信息查询

GET
/v1/customer/individual/query

接口描述

个人客户查询

请求头

参数名
类型
描述
必填
Authorization
string
Basic xyysysyysys 用户名+密码进行base64编码
必填

请求参数

参数名
类型
描述
必填
mode
string
模式 默认0000 见编码表
必填
match
string
至少一要素
可选
name
string
张之洞
可选
id_type
string
见个人证件编码表 01-身份证...
可选
id_number
string
451004198003230923
可选
md5
string
edsx6756e87326s0(三证md5结果 有md5参数查询时三要素将被忽视)
可选
business_no
string
业务编号
可选
role
string
角色编码表 投保/被保/受益 见编码表
可选
range
默认返回10条
可选
from
string
显示应该跳过的初始结果数量,默认是 0 要求值不超过 100
必填
size
string
显示应该返回的结果数量 默认10 要求值不超过 100
必填

成功返回

参数名
类型
描述
必填
status
必填
code
string
错误码,0正确,小于0表示有错误,错误信息会通过msg返回
必填
msg
string
可选
data
string
客户信息列表 一个客户信息为一个大json。"data": { "count": "@string(number,1,2)", "custormer": [{ "md5": "@string(number,8,8)", "name": "@cname", "id_number": "@string(number,16,16)", "id_type": "111" }]」 }
必填

失败返回

参数名
类型
描述
必填
status
string
错误提示信息。这是一个可选参数,可选参数用灰色显示
必填
code
string
错误码,0正确,小于0表示有错误,错误信息会通过msg返回
必填
msg
string
错误提示信息
必填

个人证件编码表

个人证件类型码表 01 居民身份证 02 护照 03 军人证 04 驾驶证 05 港澳台同胞证 06 港澳台居民居住证 07 中国护照 09 外国人永久居留身份证 10 统一信用代码 11 香港身份证 12 澳门身份证 13 回乡证 14 出生医学证明

mode编码表

五位编码 范围00000-FFFFF 默认00001 byte4:查询条件位 0 -> 按三要素查(三要素至少填一个) 1 -> 按md5查 2 -> 按业务编号+角色查(至少填一个) byte3: 按三要素查询该位才有效 0-> 精确查询 1-> 模糊查询 byte2: 查询范围 0-> 一个客户只返回一条财险全业务线中最新的记录 1-> 一个客户只返回一条本业务线中最新的记录(暂不开放) 2-> 返回该客户在财险全业务线中所有历史保单中的客户信息(暂不开放) 3-> 返回该客户在本业务线中所有历史保单中的客户信息(暂不开放) byte0-byte1: 返回内容 01-> 返回客户概要信息(等基础信息) 02-> 返回客户概要信息,查询不到则生成该客户id并返回 03-> 返回客户概要信息,查询不到则生成该客户id及信息验真结果 11-> 返回客户详细信息 查询不到则返回空 12-> 返回客户详细信息,查询不到则生成该客户id并返回 13-> 返回客户详细信息,查询不到则生成该客户id及信息验真结果

角色(role)编码表

角色编码表 00 投保人 10 主被保险人 11 附属被保险人 20 受益人

business_type(业务类型)编码表(待业务确认)

四位编码 范围0000-FFFF 默认0000 byte3-byte2: 0 -> 其他险类 1 -> 企财险 2 -> 船舶险 3 -> 雇员赔偿险 4 -> 航空险 5 -> 航天险 6 -> 货运险 7 -> 工程险 8 -> 汽车险 9 -> 信用险 10 -> 健康险 11 -> 意外险 12 -> 责任险 13 -> 综合险 14 -> 种植业 15 -> 养殖业 16 -> 保证险 17 -> 家财险 18 -> 森林保险 19 -> 农业设施保险 20 -> 天气指数保险 21 -> 农产品价格保险 22 -> 能源险 23 -> 特殊险种 24 -> 核能保险 byte1-byte0: 预留 本次意健险对接请选择 1000

个人客户信息字段(待确认)

1. 概要信息(公共基础信息) 2. 公共拓展信息(所有业务线通用) 3. 私有信息(本业务线内使用)