商品列表查询
开发中
vgs_dev
https://dapi.visageniusglobal.com
vgs_dev
https://dapi.visageniusglobal.com
POST
/openvisa/product_brief_query
一、变更说明#
| 变更内容 | 变更人 | 变更时间 |
|---|---|---|
| 商品列表/商品详情接口增加country_code(国家二字编码） | 周建成 | 2024-08-26 |
| 商品列表/商品详情接口增加visa_form(签证形式） | 周建成 | 2024-11-29 |
二、鉴权#
1、Date/X-Date#
报文创建的日期和时间（格林尼治标准时间，而不是本地时间），例如：Date: Wed, 21 Oct 2022 07:28:00 GMT。这个时间上下误差不能超过5分钟，否则会报错。2、X-Appid#
我方给的appid3、Authorization#
string s = access_key + '\n' + appid + '\n' + datestring t = base64(hmac_sha1(secret_key, s))，string Authorization = "Basic " + t请求参数
Header 参数
X-Date
string
可选
示例值:
{{gmt}}
X-Appid
string
可选
示例值:
{{appid}}
Authorization
string
可选
示例值:
{{sign}}
Body 参数application/json
country_name
string
国家名称
country_code
string
国家ISO编码
province_code
string
省份code
示例
{
"country_name": "韩国",
"province_code": "110000"
}示例代码
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/product_brief_query' \
--header 'X-Date: ' \
--header 'X-Appid: ' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
"country_name": "韩国",
"province_code": "110000"
}'返回响应
🟢200成功
application/json
Body
ret
enum<integer>
返回状态 0代表成功，其余代表失败
枚举值:
0-1
msg
string
描述信息
body
object
列表信息集合
total_count
integer
商品总数
data
array [object {13}]
商品信息
示例
{
"ret": 0,
"msg": "ok",
"body": {
"total_count": 87,
"data": [
{
"visa_type_id": 4,
"need_return_material": 0,
"validity_period_unit": "0个月",
"need_urgent": 0,
"price": 2,
"entry_count_unit": "0次",
"cover_province": [
{
"province_code": "110000",
"province_name": "北京"
},
{
"province_code": "120000",
"province_name": "天津"
},
{
"province_code": "130000",
"province_name": "河北"
},
{
"province_code": "140000",
"province_name": "山西"
},
{
"province_code": "150000",
"province_name": "内蒙古"
},
{
"province_code": "210000",
"province_name": "辽宁"
},
{
"province_code": "220000",
"province_name": "吉林"
},
{
"province_code": "230000",
"province_name": "黑龙江"
},
{
"province_code": "310000",
"province_name": "上海"
},
{
"province_code": "320000",
"province_name": "江苏"
},
{
"province_code": "330000",
"province_name": "浙江"
},
{
"province_code": "340000",
"province_name": "安徽"
},
{
"province_code": "350000",
"province_name": "福建"
},
{
"province_code": "360000",
"province_name": "江西"
},
{
"province_code": "370000",
"province_name": "山东"
},
{
"province_code": "410000",
"province_name": "河南"
},
{
"province_code": "420000",
"province_name": "湖北"
},
{
"province_code": "430000",
"province_name": "湖南"
},
{
"province_code": "440000",
"province_name": "广东"
},
{
"province_code": "450000",
"province_name": "广西"
},
{
"province_code": "460000",
"province_name": "海南"
},
{
"province_code": "500000",
"province_name": "重庆"
},
{
"province_code": "510000",
"province_name": "四川"
},
{
"province_code": "520000",
"province_name": "贵州"
},
{
"province_code": "530000",
"province_name": "云南"
},
{
"province_code": "540000",
"province_name": "西藏"
},
{
"province_code": "610000",
"province_name": "陕西"
},
{
"province_code": "620000",
"province_name": "甘肃"
},
{
"province_code": "630000",
"province_name": "青海"
},
{
"province_code": "640000",
"province_name": "宁夏"
},
{
"province_code": "650000",
"province_name": "新疆"
}
],
"product_name": "韩国-超级签",
"need_eff🟢200接口异常
🟠400参数不正确
🔴503服务异常