PDC

申请人赴馆时间更新

开发中

vgs_dev

https://dapi.visageniusglobal.com

POST

/openvisa/applicant_appointment_update

一、鉴权

每个调用方都会得到一个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_id

integer

申请人id

必需

city_id

enum<integer>

大使馆城市id

必需

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

枚举值:

0123456789101112131415

date_choice

enum<integer>

提交赴馆时间的选择

必需

，0手动选择时间 1近30天都可以 2近30天都不行

枚举值:

012

other_date

string

选择近30天都不合适时, 其他的赴馆时间备注

可选

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

preferred_date

array [object {2}]

手动选择的希望赴馆的日期

可选

date

string

日期

必需

period

integer

时间段

必需

0整天 1上午 2下午

示例

{
    "order_id": 1000012158,
    "city_id": 1,
    "applicant_id": 34460,
    "date_choice": 1,
    "preferred_date": [
        {
            "date": "2023-11-02",
            "period": 1
        }
    ],
    "other_date": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://dapi.visageniusglobal.com/openvisa/applicant_appointment_update' \
--header 'X-Date: ' \
--header 'X-Appid: ' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_id": 1000012158,
    "city_id": 1,
    "applicant_id": 34460,
    "date_choice": 1,
    "preferred_date": [
        {
            "date": "2023-11-02",
            "period": 1
        }
    ],
    "other_date": ""
}'

返回响应

🟢200成功

application/json

Body

ret

integer

必需

msg

string

必需

body

object

必需

示例

{"ret":-1,"msg":"申请人在等待预审状态下, 不容许提交"}

🟢200接口异常

🟠400参数不正确

🔴503服务异常

订单状态变更回调通知

查询国家使馆信息

申请人赴馆时间更新

一、鉴权#

1、Date/X-Date#

2、X-Appid#

3、Authorization#

请求参数

示例代码

返回响应

一、鉴权

1、Date/X-Date

2、X-Appid

3、Authorization