PDC

提交申请人资料

开发中

vgs_dev

https://dapi.visageniusglobal.com

POST

/openvisa/applicant_material_add

一、鉴权

每个调用方都会得到一个appid、access_key、secret_key，请求时，将：Date、X-Appid、Authorization放到请求头中，其中：

1、Date/X-Date

报文创建的日期和时间（格林尼治标准时间，而不是本地时间），例如：Date: Wed, 21 Oct 2022 07:28:00 GMT。这个时间上下误差不能超过5分钟，否则会报错。

2、X-Appid

我方给的appid

3、Authorization

将access_key、appid、date三个字符串拼接起来，中间以\n分割，例如：

string s = access_key + '\n' + appid + '\n' + date

然后将该字符串做hmac_sha1，得到的结果做base64，

string t = base64(hmac_sha1(secret_key, s))，

最后，Authorization的值如下：

string Authorization = "Basic " + t

请求参数

Header 参数

X-Date

string

可选

示例值:

X-Appid

string

可选

示例值:

Authorization

string

可选

示例值:

Body 参数application/json

order_id

integer

订单id

必需

applicant_set

array [object {8}]

必需

applicant_id

integer

申请人id

必需

identity_id

enum<integer>

身份id

必需

0在职人员 1自由职业者 2退休人员 3在校学生 4学龄前儿童 5通用身份

枚举值:

012345

applicant_name

string

申请人姓名

可选

material_zip_url

string

资料压缩包url

可选

city_id

integer

大使馆城市id

可选

与使馆查询接口中的city_id 一致

date_choice

integer

提交赴馆时间的选择

可选

需要赴馆时必选，0手动选择时间 1近30天都可以 2近30天都不行

other_date

string

其他时间

可选

选择近30天都不合适时, 其他的赴馆时间备注，100个字符以内

preferred_date

array [object {2}]

选择的日期

可选

手动选择的希望赴馆的日期，限制为3个

示例

{
    "order_id": 1000012399 ,
    "applicant_set": [
        {
            "identity_id": 0,
            "applicant_id": 34747,
            "material_zip_url": "https://devo.666visa.cn/tmp/在线办理-冯熟悉美国-资料模板.zip",
            "applicant_name": "陈信宏",
            "city_id":0,
            "date_choice":1
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://dapi.visageniusglobal.com/openvisa/applicant_material_add' \
--header 'X-Date: ' \
--header 'X-Appid: ' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_id": 1000012399 ,
    "applicant_set": [
        {
            "identity_id": 0,
            "applicant_id": 34747,
            "material_zip_url": "https://devo.666visa.cn/tmp/在线办理-冯熟悉美国-资料模板.zip",
            "applicant_name": "陈信宏",
            "city_id":0,
            "date_choice":1
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

ret

integer

必需

msg

string

必需

body

object

必需

示例

成功示例不支持压缩资料需要赴馆但是申请人没有带

{
    "ret":0,
    "msg":"",
    "body":{
        
    }
}

🟢200接口异常

🟠400参数不正确

🔴503服务异常

订单支付

更新申请人资料

提交申请人资料

一、鉴权#

1、Date/X-Date#

2、X-Appid#

3、Authorization#

请求参数

示例代码

返回响应

一、鉴权

1、Date/X-Date

2、X-Appid

3、Authorization