PDC
  1. 2.0
PDC
  • 上上签开发接口
    • 上上签开发接口
    • 1.0
      • 1.0
      • 商品列表查询
      • 商品详情查询
      • 创建订单
      • 订单支付
      • 提交申请人资料
      • 更新申请人资料
      • 查询订单详情
      • 订单补差价
      • 订单状态变更回调通知
      • 申请人赴馆时间更新
      • 查询国家使馆信息
      • 账单获取接口
      • 配置获取
      • 订单快递邮寄资料信息更新
      • 商品价格查询
      • 申请人发起重新审核
      • 订单回寄地址更新
      • 获取该商品最早可出行日期
      • 更新订单生效日期
    • 2.0
      • ReadMe
      • 2.0
      • 商品列表查询
        POST
      • 商品详情查询
        POST
      • 商品价格查询
        POST
      • 商品状态变更回调通知
        POST
      • 创建订单
        POST
      • 订单支付
        POST
      • 查询订单详情
        POST
      • 订单补差价
        POST
      • 上传文件
        POST
      • 申请人护照信息OCR识别
        POST
      • 申请人证件照制作
        POST
      • 查询申请人申请表url
        POST
      • 订单退款
        POST
      • 订单快递邮寄资料信息更新
        POST
      • 订单状态变更回调通知
        POST
      • 资料变更回调通知接口说明
        POST
      • 申请人赴馆时间更新
        POST
      • 查询国家使馆信息
        POST
      • 账单获取接口
        POST
      • 配置获取
        POST
      • 订单回寄地址更新
        POST
      • 申请人身份证信息OCR识别
        POST
      • 申请人资料提交（完全匹配）
        POST
      • 申请人资料重新提交
        POST
      • 申请人发起重新审核
        POST
      • 获取该商品最早可出行日期
        POST
      • 更新订单生效日期
        POST
  1. 2.0

申请人护照信息OCR识别

开发中
vgs_dev
https://dapi.visageniusglobal.com
vgs_dev
https://dapi.visageniusglobal.com
POST
/openvisa/applicant_passport_ocr

一、变更说明#

变更内容变更人变更时间
1.新增接口陈杨2023-11-22

二、接口说明#

1、需要护照OCR识别功能时，都可以调用此接口。
2、前提是先调用上传文件接口获得上上签的temp_key，并且该资料支持护照OCR识别（product_material.material.elec_material[i].pattern=2）

三、鉴权#

见:商品列表查询

请求参数

Header 参数
X-Date
string 
可选
示例值:
{{gmt}}
X-Appid
string 
可选
示例值:
{{appid}}
Authorization
string 
可选
示例值:
{{sign}}
Body 参数application/json
material_id
integer 
资料id
必需
仅支持pattern=2的电子资料
temp_key
string 
护照临时key
必需
调用上传文件接口后返回的临时key
示例
{
    "temp_key": "temp/f17005527801d0a3c35d0791393b722386272f73e75.jpg",
    "material_id": 10000
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://dapi.visageniusglobal.com/openvisa/applicant_passport_ocr' \
--header 'X-Date: ' \
--header 'X-Appid: ' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "temp_key": "temp/f17005527801d0a3c35d0791393b722386272f73e75.jpg",
    "material_id": 10000
}'

返回响应

🟢200成功
application/json
Body
ret
integer 
必需
msg
string 
必需
body
object 
必需
passport_number
string 
护照号
必需
<= 12 字符
surname_cn
string 
姓（中文）
必需
张
<= 10 字符
surname_pinyin
string 
姓（拼音）
必需
ZHANG
<= 40 字符
name_cn
string 
名（中文）
必需
三
<= 42 字符
name_pinyin
string 
名（拼音）
必需
SAN
<= 60 字符
fullname
string 
全名
必需
张三
<= 42 字符
gender
integer 
性别
必需
0男性 1女性
birthday
string 
生日
必需
1980-01-01
birth_place_cn
string 
出生地（中文）
必需
以省份算，如：上海
birth_place_pinyin
string 
出生地（拼音）
必需
以省份算，如：SHANGHAI
issue_place_cn
string 
签发地（中文）
必需
以省份算，如：广东
issue_place_pinyin
string 
签发地（拼音）
必需
以省份算，如：GUANGDONG
issue_date
string 
签发日期
必需
1980-01-01
expire_date
string 
有效期至
必需
1980-01-01
issue_authority_cn
string 
签发机构（中文）
必需
<= 30 字符
issue_authority_en
string 
签发机构（英文）
必需
<= 100 字符
temp_key
string 
图片临时key
必需
original
string 
原图链接
必需
url
string 
展示链接
必需
示例
{"ret":0,"msg":"ok","body":{"birthday":"1992-03-08","expire_date":"2033-05-09","issue_authority_en":"National Immigration Administration,PRC","issue_place_pinyin":"JIANGSU","birth_place_cn":"江苏","url":"https://devo.666visa.cn/temp/f17005567270d37d117ffeeb28bab6ba775ef050138.jpg","fullname":"曹笠恺","issue_place_cn":"江苏","original":"https://devo.666visa.cn/temp/f17005567273b1e7ac9aa5174a61b8ddafe335b6396.jpg","name_pinyin":"LIKAI","name_cn":"笠恺","temp_key":"temp/f17005567270d37d117ffeeb28bab6ba775ef050138.jpg","passport_number":"EK4210492","birth_place_pinyin":"JIANGSU","issue_authority_cn":"中华人民共和国国家移民管理局","surname_cn":"曹","gender":0,"issue_date":"2023-05-10","surname_pinyin":"CAO"}}
🟢200接口异常
🟠400参数不正确
🔴503服务异常
修改于 2025-04-14 06:41:10
上一页
上传文件
下一页
申请人证件照制作
Built with