接口文档
供「出境查」小程序调用。默认只返回已复核 / 已发布的数据，草稿不会外泄。
GET
/api/v1/countries国家列表 + 签证政策摘要
| q | 按中文名 / 英文名 / ISO 码模糊搜索 |
| continent | 大洲筛选，如 亚洲、欧洲 |
| category | visa_free / visa_on_arrival / evisa / visa_required / transit_free / restricted / domestic_region |
| holding | 持他国签证可免签筛选，如 US、Schengen、CA、JP、UK、AU、NZ |
| include | 传 draft 时一并返回未复核的草稿数据（默认不返回） |
| limit | 最大条数，默认 500，上限 1000 |
GET
/api/v1/countries/{cca2}单个国家详情，含来源佐证与是否过期标记
| cca2 | ISO 3166-1 二位码，如 TH、JP、US |
category 取值
| visa_free | 免签 |
| visa_on_arrival | 落地签 / 口岸签 |
| evisa | 电子签 / 电子旅行授权 |
| visa_required | 需提前办理签证 |
| transit_free | 过境免签 |
| restricted | 限制或禁止入境 |
| domestic_region | 中国境内地区（港澳台，适用通行证制度） |
| unknown | 尚未核实 |
持他国签证免签（holding 参数）
很多国家允许「持有效美国/申根/加拿大等签证」的中国公民免签或简化入境。 这是小程序的高价值功能点：让用户勾选「我持有的签证」，推荐可免签目的地。
| key | 含义 |
|---|---|
| US | 美国签证 / 绿卡 |
| Schengen | 申根签证 |
| CA | 加拿大签证 / 枫叶卡 |
| JP | 日本签证 |
| UK | 英国签证 |
| AU | 澳大利亚签证 / 绿卡 |
| NZ | 新西兰签证 |
| KR | 韩国签证 |
| IRL | 爱尔兰签证 |
示例：GET /api/v1/countries?holding=US —— 返回所有持美签可免签/简化入境的目的地。 单条数据里的
visa.visaByHolding 字段为 { visaKeys: [...], note }。小程序接入建议
- 1. 首屏用
/api/v1/countries拉全量（约 200 条，几十 KB），本地缓存。 - 2. 详情页用
/api/v1/{cca2}拉带来源的详情，展示来源链接提升可信度。 - 3. 若接口返回
expired: true，前端应显式提示「该政策已过期，请核实」。 - 4. 页面底部必须保留免责说明，指向官方源。参考 后台数据 中每条记录的来源链接。