查询国家使馆信息

开发中

vgs_dev

POST

/openvisa/country_embassy_get

一、变更说明

变更记录	变更人	变更时间
接口返回增加城市名称city_name	周建成	2023-11-22

二、鉴权

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

country_id

integer

国家id

必需

国家id可以从商品详情里获取

示例

{
  "country_id": 10000
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://dapi.visageniusglobal.com/openvisa/country_embassy_get' \
--header 'X-Date: ' \
--header 'X-Appid: ' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "country_id": 10000
}'

返回响应

🟢200成功

application/json

Body

ret

integer

必需

msg

string

必需

body

object

必需

embassy_set

array [object {4}]

必需

示例

{
  "ret": 0,
  "msg": "ok",
  "body": {
    "embassy_set": [
      {
        "country_id": 10000,
        "earliest_date": "2019-03-30",
        "city_id": 1,
        "city_name": "北京"
      },
      {
        "country_id": 10000,
        "earliest_date": "2019-03-30",
        "city_id": 2,
        "city_name": "上海"
      }
    ]
  }
}

🟢200接口异常

🟠400参数不正确

🔴503服务异常

修改于 2024-01-23 02:52:26

申请人赴馆时间更新

账单获取接口

查询国家使馆信息

一、变更说明#

二、鉴权#

1、Date/X-Date#

2、X-Appid#

3、Authorization#

请求参数

示例代码

返回响应

一、变更说明

二、鉴权

1、Date/X-Date

2、X-Appid

3、Authorization