- 上上签开发接口
- 上上签开发接口
- 1.0
- 2.0
- ReadMe
- 2.0
- 商品列表查询POST
- 商品详情查询POST
- 商品价格查询POST
- 商品状态变更回调通知POST
- 创建订单POST
- 订单支付POST
- 查询订单详情POST
- 订单补差价POST
- 上传文件POST
- 申请人护照信息OCR识别POST
- 申请人证件照制作POST
- 查询申请人申请表urlPOST
- 订单退款POST
- 订单快递邮寄资料信息更新POST
- 订单状态变更回调通知POST
- 资料变更回调通知接口说明POST
- 申请人赴馆时间更新POST
- 查询国家使馆信息POST
- 账单获取接口POST
- 配置获取POST
- 订单回寄地址更新POST
- 申请人身份证信息OCR识别POST
- 申请人资料提交(完全匹配)POST
- 申请人资料重新提交POST
- 申请人发起重新审核POST
- 获取该商品最早可出行日期POST
- 更新订单生效日期POST
申请人资料提交(完全匹配)
开发中
vgs_dev
https://dapi.visageniusglobal.com
vgs_dev
https://dapi.visageniusglobal.com
POST
/openvisa/applicant_material_submit
一、调用前提#
二、变更说明#
变更内容 | 变更人 | 变更时间 |
---|---|---|
1.如果资料存在身份证OCR类型(pattern = 1)增加必传id_card结构 | 陈杨 | 2024-07-19 |
2.如果资料存在婚姻证明(pattern = 3)增加上送项marital_status(婚姻状态) | 陈杨 | 2024-07-19 |
三、接口说明#
temp_key
后在进行上传。2、证件照可以使用制作证件照,也可以直接上传原图
3、如果商品必填的电子资料(
elec_material
)有护照OCR类型(pattern=2
),那必传passport
(护照OCR信息)。如有身份证OCR类型(pattern=1
)那必传id_card
(身份证OCR信息)4、如果有申请表(application),需要填写完申请表才能提交资料
四、鉴权#
请求参数
Header 参数
X-Date
string
可选
示例值:
{{gmt}}
X-Appid
string
可选
示例值:
{{appid}}
Authorization
string
可选
示例值:
{{sign}}
Body 参数application/json
order_id
integer
订单id
applicant_set
array [object {8}]
必需
applicant_id
integer
申请人id
identity_id
enum<integer>
身份id
枚举值:
012345
applicant_name
string
申请人姓名
city_id
integer
大使馆城市id
date_choice
integer
提交赴馆时间的选择
other_date
string
其他时间
preferred_date
array [object {2}]
选择的日期
material_set
object
申请人资料
示例
{
"order_id": 61912630,
"applicant_set": [
{
"applicant_id": -39993911,
"identity_id": 0,
"applicant_name": "dolore consequat",
"city_id": 6804833,
"date_choice": -12433121,
"other_date": "voluptate consequat Duis",
"preferred_date": [
{
"date": "2025-03-13 19:33:55",
"period": 0
},
{
"date": "2024-12-15 12:37:43",
"period": 0
},
{
"date": "2025-08-29 04:25:30",
"period": 0
}
],
"material_set": {
"elec_material": [
{
"material_id": 80774012,
"marital_status": 56942813,
"file_list": [
{
"file_id": "nulla mollit",
"temp_key": "dolore dolor qui"
}
]
},
{
"material_id": 9192391,
"marital_status": 1027336,
"file_list": [
{
"file_id": "culpa enim proident",
"temp_key": "exercitation"
},
{
"file_id": "veniam nostrud in consectetur",
"temp_key": "labore cupidatat qui incididunt aute"
}
]
},
{
"material_id": 99741771,
"marital_status": -49198953,
"file_list": [
{
"file_id": "qui",
"temp_key": "Duis Lorem ex"
},
{
"file_id": "pariatur aliqua adipisicing",
"temp_key": "cillum reprehenderit Ut"
},
{
"file_id": "eiusmod aliqua Duis",
"temp_key": "culpa in do"
}
]
}
],
"idphoto": {
"original_temp_key": "irure id est officia",
"temp_key": "Lorem voluptate"
},
"passport": {
"passport_number": "sint cillum",
"surname_cn": "折",
"surname_pinyin": "Anais",
"name_cn": "鹏涛",
"name_pinyin": "velit ex quis est",
"fullname": "qui culpa",
"gender": -39889857,
"birthday": "qui laborum enim sint",
"birth_place_cn": "pariatur ex in",
"birth_place_pinyin": "est ex ipsum",
"issue_place_cn": "sed consequat ut Ut",
"issue_place_pinyin": "est nulla cupidatat",
"issue_date": "proident incididunt et",
"expire_date": "in laborum",
"issue_authority_cn": "elit nulla exercitati",
"issue_authority_en": "officia",
"original": "Ut in veniam eu mollit",
"url": "voluptate velit et",
"file_id": "labore"
},
"id_card": {
"special_code": -58581162.30816868,
"id_no": "dolore enim aute esse",
"fullname": "sint cillum aute",
"gender": 62484432,
"nation": "elit aliquip",
"birthday": "2023-05-09",
"address": "sed ad",
"expire_date": "ut fugiat ea eu magna",
"issue_authority": "laborum",
"front_original": "sint",
"back_original": "dolor",
"front_url": "deserunt fugiat occaecat veniam",
"back_url": "sed exercitation",
"front_file_id": "Duis cupidatat",
"back_file_id": "Excepteur do dolore cillum"
}
}
},
{
"applicant_id": -61246679,
"identity_id": 5,
"applicant_name": "in laborum",
"city_id": -29878112,
"date_choice": -2191879,
"other_date": "consequat laboris",
"preferred_date": [
{
"date": "2025-01-05 17:57:22",
"period": 0
},
{
"date": "2025-04-28 01:49:53",
"period": 0
}
],
"material_set": {
"elec_material": [
{
"material_id": 81732462,
"marital_status": -37416387,
"file_list": [
{
"file_id": "aliqua quis ullamco",
"temp_key": "ut"
}
]
},
{
"material_id": -10004768,
"marital_status": 55389817,
"file_list": [
{
"file_id": "ut ut consectetur",
"temp_key": "dolor"
},
{
"file_id": "dolore id et incididunt nisi",
"temp_key": "non pariatur ea proident"
}
]
},
{
"material_id": 16300364,
"marital_status": 32240466,
"file_list": [
{
"file_id": "quis",
"temp_key": "sed aliquip ut dolor do"
}
]
}
],
"idphoto": {
"original_temp_key": "cillum consectetur nulla qui",
"temp_key": "nisi ut"
},
"passport": {
"passport_number": "in",
"surname_cn": "皋",
"surname_pinyin": "Mckenzie",
"name_cn": "鑫鹏",
"name_pinyin": "minim ipsum esse",
"fullname": "sed dolo",
"gender": -54489617,
"birthday": "id",
"birth_place_cn": "do proident nostrud enim",
"birth_place_pinyin": "Duis",
"issue_place_cn": "sint Excepteur nulla voluptate ad",
"issue_place_pinyin": "ea sunt anim dolore eu",
"issue_date": "culpa est fugiat in",
"expire_date": "in anim",
"issue_authority_cn": "amet esse",
"issue_authority_en": "in quis amet",
"original": "quis",
"url": "dolore in",
"file_id": "anim consequat in in"
},
"id_card": {
"special_code": 65540979.9623687,
"id_no": "enim labore ex",
"fullname": "et enim culpa dolor",
"gender": 41443052,
"nation": "Excepteur",
"birthday": "2022-02-14",
"address": "est velit dolor veniam",
"expire_date": "enim in",
"issue_authority": "in exercitation quis",
"front_original": "id enim officia irure",
"back_original": "laboris adipisicing aliqua nulla deserunt",
"front_url": "ad eiusmod mollit labore consequat",
"back_url": "sed velit in",
"front_file_id": "eu elit laboris velit",
"back_file_id": "dolor Ut eiusmod sed laboris"
}
}
},
{
"applicant_id": 80640426,
"identity_id": 4,
"applicant_name": "esse eiusmod",
"city_id": -9764587,
"date_choice": -34207549,
"other_date": "in ipsum",
"preferred_date": [
{
"date": "2024-04-13 04:21:50",
"period": 0
},
{
"date": "2025-04-11 20:43:06",
"period": 0
}
],
"material_set": {
"elec_material": [
{
"material_id": 51135573,
"marital_status": 95212325,
"file_list": [
{
"file_id": "sunt",
"temp_key": "Duis ipsum velit et"
}
]
},
{
"material_id": 56052788,
"marital_status": -96426920,
"file_list": [
{
"file_id": "exercitation laboris",
"temp_key": "commodo non nostrud reprehenderit"
},
{
"file_id": "esse nostrud mollit",
"temp_key": "sint anim ut cupidatat"
}
]
},
{
"material_id": 23405071,
"marital_status": 56173837,
"file_list": [
{
"file_id": "quis dolor non velit",
"temp_key": "irure do aliqua et"
},
{
"file_id": "cupidatat",
"temp_key": "sunt"
}
]
}
],
"idphoto": {
"original_temp_key": "sed nulla do ad ex",
"temp_key": "sint occaecat consequat minim do"
},
"passport": {
"passport_number": "reprehender",
"surname_cn": "类",
"surname_pinyin": "Kennith",
"name_cn": "烨华",
"name_pinyin": "sit dolor minim sunt esse",
"fullname": "Excepteur adipisicing ve",
"gender": 84295144,
"birthday": "Excepteur Lorem nisi",
"birth_place_cn": "ex non mollit",
"birth_place_pinyin": "magna",
"issue_place_cn": "nisi quis tempor",
"issue_place_pinyin": "laboris dolor fugiat",
"issue_date": "quis laborum sed dolor",
"expire_date": "est quis elit sint",
"issue_authority_cn": "incid",
"issue_authority_en": "aliqua elit ullamco",
"original": "voluptate pariatur proident sunt",
"url": "dolore dolor aliquip adipisicing Lorem",
"file_id": "et ut"
},
"id_card": {
"special_code": 15110626.08013165,
"id_no": "non deserunt nulla occaecat",
"fullname": "deserunt ad id",
"gender": 95471878,
"nation": "consequat laboris amet veniam laborum",
"birthday": "1991-08-17",
"address": "in consectetur",
"expire_date": "ipsum",
"issue_authority": "aliquip nisi anim",
"front_original": "commodo",
"back_original": "occaecat Excepteur ex Lorem laboris",
"front_url": "eu commodo aliquip esse culpa",
"back_url": "in",
"front_file_id": "sed ea dolor",
"back_file_id": "sed consectetur exercitation aliquip occaecat"
}
}
}
]
}
示例代码
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_material_submit' \
--header 'X-Date: ' \
--header 'X-Appid: ' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
"order_id": 61912630,
"applicant_set": [
{
"applicant_id": -39993911,
"identity_id": 0,
"applicant_name": "dolore consequat",
"city_id": 6804833,
"date_choice": -12433121,
"other_date": "voluptate consequat Duis",
"preferred_date": [
{
"date": "2025-03-13 19:33:55",
"period": 0
},
{
"date": "2024-12-15 12:37:43",
"period": 0
},
{
"date": "2025-08-29 04:25:30",
"period": 0
}
],
"material_set": {
"elec_material": [
{
"material_id": 80774012,
"marital_status": 56942813,
"file_list": [
{
"file_id": "nulla mollit",
"temp_key": "dolore dolor qui"
}
]
},
{
"material_id": 9192391,
"marital_status": 1027336,
"file_list": [
{
"file_id": "culpa enim proident",
"temp_key": "exercitation"
},
{
"file_id": "veniam nostrud in consectetur",
"temp_key": "labore cupidatat qui incididunt aute"
}
]
},
{
"material_id": 99741771,
"marital_status": -49198953,
"file_list": [
{
"file_id": "qui",
"temp_key": "Duis Lorem ex"
},
{
"file_id": "pariatur aliqua adipisicing",
"temp_key": "cillum reprehenderit Ut"
},
{
"file_id": "eiusmod aliqua Duis",
"temp_key": "culpa in do"
}
]
}
],
"idphoto": {
"original_temp_key": "irure id est officia",
"temp_key": "Lorem voluptate"
},
"passport": {
"passport_number": "sint cillum",
"surname_cn": "折",
"surname_pinyin": "Anais",
"name_cn": "鹏涛",
"name_pinyin": "velit ex quis est",
"fullname": "qui culpa",
"gender": -39889857,
"birthday": "qui laborum enim sint",
"birth_place_cn": "pariatur ex in",
"birth_place_pinyin": "est ex ipsum",
"issue_place_cn": "sed consequat ut Ut",
"issue_place_pinyin": "est nulla cupidatat",
"issue_date": "proident incididunt et",
"expire_date": "in laborum",
"issue_authority_cn": "elit nulla exercitati",
"issue_authority_en": "officia",
"original": "Ut in veniam eu mollit",
"url": "voluptate velit et",
"file_id": "labore"
},
"id_card": {
"special_code": -58581162.30816868,
"id_no": "dolore enim aute esse",
"fullname": "sint cillum aute",
"gender": 62484432,
"nation": "elit aliquip",
"birthday": "2023-05-09",
"address": "sed ad",
"expire_date": "ut fugiat ea eu magna",
"issue_authority": "laborum",
"front_original": "sint",
"back_original": "dolor",
"front_url": "deserunt fugiat occaecat veniam",
"back_url": "sed exercitation",
"front_file_id": "Duis cupidatat",
"back_file_id": "Excepteur do dolore cillum"
}
}
},
{
"applicant_id": -61246679,
"identity_id": 5,
"applicant_name": "in laborum",
"city_id": -29878112,
"date_choice": -2191879,
"other_date": "consequat laboris",
"preferred_date": [
{
"date": "2025-01-05 17:57:22",
"period": 0
},
{
"date": "2025-04-28 01:49:53",
"period": 0
}
],
"material_set": {
"elec_material": [
{
"material_id": 81732462,
"marital_status": -37416387,
"file_list": [
{
"file_id": "aliqua quis ullamco",
"temp_key": "ut"
}
]
},
{
"material_id": -10004768,
"marital_status": 55389817,
"file_list": [
{
"file_id": "ut ut consectetur",
"temp_key": "dolor"
},
{
"file_id": "dolore id et incididunt nisi",
"temp_key": "non pariatur ea proident"
}
]
},
{
"material_id": 16300364,
"marital_status": 32240466,
"file_list": [
{
"file_id": "quis",
"temp_key": "sed aliquip ut dolor do"
}
]
}
],
"idphoto": {
"original_temp_key": "cillum consectetur nulla qui",
"temp_key": "nisi ut"
},
"passport": {
"passport_number": "in",
"surname_cn": "皋",
"surname_pinyin": "Mckenzie",
"name_cn": "鑫鹏",
"name_pinyin": "minim ipsum esse",
"fullname": "sed dolo",
"gender": -54489617,
"birthday": "id",
"birth_place_cn": "do proident nostrud enim",
"birth_place_pinyin": "Duis",
"issue_place_cn": "sint Excepteur nulla voluptate ad",
"issue_place_pinyin": "ea sunt anim dolore eu",
"issue_date": "culpa est fugiat in",
"expire_date": "in anim",
"issue_authority_cn": "amet esse",
"issue_authority_en": "in quis amet",
"original": "quis",
"url": "dolore in",
"file_id": "anim consequat in in"
},
"id_card": {
"special_code": 65540979.9623687,
"id_no": "enim labore ex",
"fullname": "et enim culpa dolor",
"gender": 41443052,
"nation": "Excepteur",
"birthday": "2022-02-14",
"address": "est velit dolor veniam",
"expire_date": "enim in",
"issue_authority": "in exercitation quis",
"front_original": "id enim officia irure",
"back_original": "laboris adipisicing aliqua nulla deserunt",
"front_url": "ad eiusmod mollit labore consequat",
"back_url": "sed velit in",
"front_file_id": "eu elit laboris velit",
"back_file_id": "dolor Ut eiusmod sed laboris"
}
}
},
{
"applicant_id": 80640426,
"identity_id": 4,
"applicant_name": "esse eiusmod",
"city_id": -9764587,
"date_choice": -34207549,
"other_date": "in ipsum",
"preferred_date": [
{
"date": "2024-04-13 04:21:50",
"period": 0
},
{
"date": "2025-04-11 20:43:06",
"period": 0
}
],
"material_set": {
"elec_material": [
{
"material_id": 51135573,
"marital_status": 95212325,
"file_list": [
{
"file_id": "sunt",
"temp_key": "Duis ipsum velit et"
}
]
},
{
"material_id": 56052788,
"marital_status": -96426920,
"file_list": [
{
"file_id": "exercitation laboris",
"temp_key": "commodo non nostrud reprehenderit"
},
{
"file_id": "esse nostrud mollit",
"temp_key": "sint anim ut cupidatat"
}
]
},
{
"material_id": 23405071,
"marital_status": 56173837,
"file_list": [
{
"file_id": "quis dolor non velit",
"temp_key": "irure do aliqua et"
},
{
"file_id": "cupidatat",
"temp_key": "sunt"
}
]
}
],
"idphoto": {
"original_temp_key": "sed nulla do ad ex",
"temp_key": "sint occaecat consequat minim do"
},
"passport": {
"passport_number": "reprehender",
"surname_cn": "类",
"surname_pinyin": "Kennith",
"name_cn": "烨华",
"name_pinyin": "sit dolor minim sunt esse",
"fullname": "Excepteur adipisicing ve",
"gender": 84295144,
"birthday": "Excepteur Lorem nisi",
"birth_place_cn": "ex non mollit",
"birth_place_pinyin": "magna",
"issue_place_cn": "nisi quis tempor",
"issue_place_pinyin": "laboris dolor fugiat",
"issue_date": "quis laborum sed dolor",
"expire_date": "est quis elit sint",
"issue_authority_cn": "incid",
"issue_authority_en": "aliqua elit ullamco",
"original": "voluptate pariatur proident sunt",
"url": "dolore dolor aliquip adipisicing Lorem",
"file_id": "et ut"
},
"id_card": {
"special_code": 15110626.08013165,
"id_no": "non deserunt nulla occaecat",
"fullname": "deserunt ad id",
"gender": 95471878,
"nation": "consequat laboris amet veniam laborum",
"birthday": "1991-08-17",
"address": "in consectetur",
"expire_date": "ipsum",
"issue_authority": "aliquip nisi anim",
"front_original": "commodo",
"back_original": "occaecat Excepteur ex Lorem laboris",
"front_url": "eu commodo aliquip esse culpa",
"back_url": "in",
"front_file_id": "sed ea dolor",
"back_file_id": "sed consectetur exercitation aliquip occaecat"
}
}
}
]
}'
返回响应
🟢200成功
application/json
Body
ret
integer
必需
msg
string
必需
body
object
必需
示例
{
"ret":0,
"msg":"",
"body":{
}
}
🟢200接口异常
🟠400参数不正确
🔴503服务异常