文档
测试

身份证信息上传

POST
/api/v1/idcards/new

接口描述

身份证信息的上传,以及认证

请求头

参数名
类型
描述
必填
os
string
示例:ios
必填
authorization
string
示例:bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9hbi1hcGkuY29tLy9hcGkvdjEvdXNlcnMvcXVpY2siLCJpYXQiOjE1Njc1NjQyNTgsImV4cCI6MTU2ODg2MDI1OCwibmJmIjoxNTY3NTY0MjU4LCJqdGkiOiJQR3l6N3ZKT0Jjc3hDanNkIiwic3ViIjoyLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.6KulRuAPFFFkGXfXmRG7x8VkQJUOpYgyD5zufGoRpgE
必填

请求参数

参数名
类型
描述
必填
name
string
姓名。示例:老刘
必填
number
number
身份证号。示例:410185199012056666
必填
sex
string
性别。示例:男
必填
nation
string
民族。示例:汉
必填
year
number
年。示例:1990
必填
month
number
月。示例:12
必填
day
number
日。示例:5
必填
address
string
地址。示例:河南省郑州市
必填
authority
string
发证机关。示例:郑州市
必填
timelimit
string
有效期。示例:20101002-20201205
必填
front
string
身份证正面。示例:users/1/font.jpg
必填
back
string
身份证反面。示例:users/1/back.jpg
必填
screenshot
string
活体截图。示例:users/1/screenshot.jpg
必填
similar
number
相似度。示例:0.96
可选
threshold1
string
千分之⼀阈值。
可选
threshold2
string
万分之⼀阈值
可选

响应参数

参数名
类型
描述
必填
code
number
响应状态码。20000/20200/40120/40121/50000
必填
status
string
响应状态:success/fail/error
必填
msg
string
示例:上传成功
必填
data
object
数据字典
必填