PDC
  1. 2.0
PDC
  • 上上签开发接口
    • 2.0
      • ReadMe
      • 2.0
      • 商品列表查询
        POST
      • 商品详情查询
        POST
      • 商品价格查询
        POST
      • 商品状态变更回调通知
        POST
      • 创建订单
        POST
      • 订单支付
        POST
      • 查询订单详情
        POST
      • 订单补差价
        POST
      • 上传文件
        POST
      • 申请人护照信息OCR识别
        POST
      • 申请人证件照制作
        POST
      • 查询申请人申请表url
        POST
      • 订单退款
        POST
      • 订单快递邮寄资料信息更新
        POST
      • 订单状态变更回调通知
        POST
      • 资料变更回调通知接口说明
        POST
      • 申请人赴馆时间更新
        POST
      • 查询国家使馆信息
        POST
      • 账单获取接口
        POST
      • 配置获取
        POST
      • 订单回寄地址更新
        POST
      • 申请人身份证信息OCR识别
        POST
      • 申请人资料提交（完全匹配）
        POST
      • 申请人资料重新提交
        POST
      • 申请人发起重新审核
        POST
      • 获取该商品最早可出行日期
        POST
      • 更新订单生效日期
        POST
  1. 2.0

商品列表查询

开发中
POST
/openvisa/product_brief_query

一、变更说明#

变更内容变更人变更时间
放开对直连商品的限制陈杨2023-11-22
请求参数增加country_code，country_name和country_code至少要传一个陈杨2024-05-29
商品列表/商品详情接口增加country_code(国家二字编码）周建成2024-08-26
商品列表/商品详情接口增加visa_form(签证形式）周建成2024-11-29

二、接口说明#

根据国家名称/国家ISO二字码，搜索商品列表

三、鉴权#

每个调用方都会得到一个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 
可选
示例值:
{{gmt}}
X-Appid
string 
可选
示例值:
{{appid}}
Authorization
string 
可选
示例值:
{{sign}}
Body 参数application/json
country_name
string 
国家名称
必需
country_name与country_code至少输入一个
country_code
string 
国家编码
必需
country_name与country_code至少输入一个，ISO2位编码，不区分大小写，可参考此链接ISO代码一栏2位的数据：https://countrycodebase.com/zh-hans/
province_code
string 
省份code
可选
覆盖省份（cover_province），不需要根据省份查询时不需要该参数，传空字符串也不行。部分商品只适用个别省份的客户，比如某个日本签证只适用上海地区。
示例
{
    "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://testapi.666visa.cn/openvisa/product_brief_query' \
--header 'X-Date: ' \
--header 'X-Appid: {{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":154,"data":[{"visa_type_id":4,"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":"新疆"}],"price":0,"validity_period_unit":"12个月","entry_count_unit":"2次","product_id":10067,"visa_country":{"country_id":10011,"country_name":"美国"},"product_name":"这是刷的数据，请更新简要名称"},{"visa_type_id":5,"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":"新疆"}],"price":0,"validity_period_unit":"6个月","entry_count_unit":"3次","product_id":10108,"visa_country":{"country_id":10011,"country_name":"美国"},"product_name":"这是刷的数据，请更新简要名称"},{"visa_type_id":5,"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":"新疆"}],"price":0,"validity_period_unit":"2个月","entry_count_unit":"4次","product_id":10168,"visa_country":{"country_id":10011,"country_name":"美国"},"product_name":"这是刷的数据，请更新简要名称"},{"visa_type_id":4,"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":"新疆"}],"price":0,"validity_period_unit":"12个月","entry_count_unit":"2次","product_id":10169,"visa_country":{"country_id":10011,"country_name":"美国"},"product_name":"美国旅游签需面试"},{"visa_type_id":5,"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":"新疆"}],"price":0,"validity_period_unit":"6个月","entry_count_unit":"1次","product_id":10186,"visa_country":{"country_id":10011,"country_name":"美国"},"product_name":"面试不陪签"},{"visa_type_id":4,"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":"新疆"}],"price":0,"validity_period_unit":"12个月","entry_count_unit":"2次","product_id":10268,"visa_country":{"country_id":10011,"country_name":"美国"},"product_name":"美国旅游签-申请表"},{"visa_type_id":4,"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":"新疆"}],"price":0,"validity_period_unit":"12个月","entry_count_unit":"2次","product_id":10281,"visa_country":{"country_id":10011,"country_name":"美国"},"product_name":"这是刷的数据，请更新简要名称"},{"visa_type_id":4,"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":"新疆"},{"province_code":"710000","province_name":"台湾"},{"province_code":"810000","province_name":"香港"},{"province_code":"820000","province_name":"澳门"}],"price":0,"validity_period_unit":"使馆批","entry_count_unit":"使馆批","product_id":10410,"visa_country":{"country_id":10011,"country_name":"美国"},"product_name":"这是刷的数据，请更新简要名称"},{"visa_type_id":5,"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":"新疆"}],"price":0,"validity_period_unit":"6个月","entry_count_unit":"1次","product_id":10445,"visa_country":{"country_id":10011,"country_name":"美国"},"product_name":"面试含陪签"},{"visa_type_id":4,"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":"新疆"},{"province_code":"710000","province_name":"台湾"},{"province_code":"810000","province_name":"香港"},{"province_code":"820000","province_name":"澳门"}],"price":0,"validity_period_unit":"2个月","entry_count_unit":"1次","product_id":10450,"visa_country":{"country_id":10011,"country_name":"美国"},"product_name":"美国旅游签申请表测试"}]}}
🟢200接口异常
🟠400参数不正确
🔴503服务异常
上一页
2.0
下一页
商品详情查询
Built with