它能做什么
签证查询小组件是我们套件中呼声最高的嵌入组件。它直接回答旅行内容最常见的问题——“我需要签证吗？”——而不必把读者送去第三方网站、切断你的转化漏斗。
在底层，小组件查询的是 Orizn 签证图谱：一个包含 39 601 个护照-目的地组合的数据库，每晚由使馆数据源、IATA、政府新闻稿以及我们覆盖 200+ 官方站点的爬虫核对更新。每个组合都包含政策类型（免签、落地签、电子签、使馆签、拒签）、最长停留、办理时长、费用和权威来源 URL。
读者在可搜索的选择器中选定护照（199 个选项，均以母语显示国名），点选目的地，结果卡片在 200 毫秒内返回：入境规则、下一步 CTA，以及指向该目的地完整 Orizn 旅行指南的可选联盟链接。小组件完全自挂载——无需调用初始化函数、无需接入 React Provider——适用于任何 HTML 页面、所有主流 CMS，并可通过 next/script 用于 React/Next.js。
小组件构建器
下方的小组件运行的正是你将粘贴到自己网站上的生产脚本。每个选项都会即时更新预览和代码——语言、主题、颜色、白标——调好后复制两行代码即可。
Live preview · updates as you type
The widget above runs the exact production script you would paste on your own site — async, zero dependencies, scoped CSS. Every option on the left maps to a data-* attribute in the snippet.
功能特性
具体、有数据来源的功能——不是空泛的勾选项。以下每一条今天都已在生产版小组件中上线。
签证规则随时可能变动。我们的数据管道每 24 小时从 200+ 官方使馆网站、IATA 及 Timatic 同级数据源抓取数据，并在发布前完成冲突核对。
完整覆盖 ISO 3166-1。访客只需选择一次护照，小组件通过一枚第一方 cookie 在后续访问中自动记住。
当需要办理签证时，小组件直接给出最近的使馆或电子签证官方入口链接，无需额外点击。
结果卡片同时显示目的地的日均预算和访客护照的通行力评分，一个小组件一次回答三个问题。
一键复制带有访客护照预填参数的深度链接，可直接私信给旅伴而不丢失上下文。
自动检测访客浏览器语言。若你的受众为单一语言，可用 data-lang 锁定特定语言。
添加 data-affiliate="ORIZN-XXXXX"（aff_… 格式亦可），此后每笔指南购买的 50% 归你，点击后 30 天内均可归因。
纯原生 JS，无 React、无 jQuery。对 Lighthouse 分数影响可忽略不计，CSS 作用域隔离避免样式冲突。
最佳场景
小组件是通用的，但以下四类用户使用最多。只要你符合其中任何一类，粘贴代码后几分钟内就能见效。
在每篇国家攻略顶部嵌入一次。读者无需离开你的文章，即可得到“去越南要签证吗？”的答案。
把小组件放到高流量的存量文章上。50/50 的指南分成能让 AdSense 收益偏低的页面重新盈利。
把小组件加到欢迎页或置顶文章。订阅者获得即时签证查询，你获得可归因的销售。
在 /resources 页面置顶小组件。成员规划下一个落脚国家时，几秒钟就能查清入境资格。
数据从何而来
签证政策由官方使馆数据源、IATA Timatic 同级来源、政府新闻稿以及一套覆盖 200+ 部委网站的自研 Rust 爬虫共同核对。每个数据单元悬停即可查看来源 URL，整个图谱每晚重建，任何政策变更须经双来源一致的质量门槛才会发布。
参考
每个选项都是容器 div 上的一个 data-* 属性。无需任何 JavaScript 配置——粘贴、设置想要的属性、上线。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
data-destination | ISO3 | "" | 预填目的地国家（如 VNM、THA、JPN）。访客仍可自行更改。 |
data-lang | string | "auto" | 覆盖浏览器语言自动检测。支持 16 种语言：en、fr、es、de、it、pt、ja、ko、zh、ru、ar、hi、th、vi、tl、tr（阿拉伯语以 RTL 呈现）。 |
data-theme | string | "auto" | 强制主题："auto"（跟随系统）、"light" 或 "dark"。 |
data-affiliate | string | "" | 你的 ORIZN-XXXXX 或 aff_… 联盟代码（两种格式均可）。设置后才能获得指南销售的 50/50 分成。 |
data-show-score | bool | true | 控制结果卡片中免签评分徽章的显示与隐藏。 |
data-show-budget | bool | true | 控制签证结果下方内嵌日均预算估算的显示与隐藏。 |
data-show-guide | bool | true | 控制用于联盟转化的“购买完整旅行指南”CTA 的显示与隐藏。 |
data-color | hex | #2563EB | 按钮、焦点环、链接及结果徽章的强调色。仅接受十六进制色值（会做安全过滤）。 |
data-branding | string | "on" | 设为 "off" 即可白标：隐藏“Powered by Orizn”页脚、JSON-LD 结构化数据以及分享文案中的 orizn.app 字样。 |
data-radius | int | 16 | 小组件卡片和输入框的圆角半径（px）。 |
data-font | string | "system-ui" | 整个小组件使用的字体族。任何 CSS 字体栈均可。 |
data-no-cookie | bool | false | GDPR 模式：设为 true 时小组件完全不写入 cookie（跨访问的护照记忆功能将被禁用）。 |
data-api-key | string | "" | 可选的 Orizn API key。设置后，查询将计入你套餐的配额，而非共享公共配额池。 |
集成
同样的两行代码，不同技术栈的粘贴路径略有差异。各 CMS 的分步指南：
变现
在容器 div 上添加 data-affiliate="ORIZN-XXXXX" 即可——ORIZN-… 和 aff_… 两种代码格式均可。读者通过小组件购买的每份指南在点击后 30 天内归因到你，收益每月通过 Stripe 结算。无最低门槛、无追回条款，联盟后台数据完全透明。
常见问题
来自集成小组件的开发者、博主和联盟营销者的真实问题。如果没找到你的问题，/embed/getting-started 的文档覆盖了更长尾的内容。
相关小组件
五个小组件共享同一运行时，因此在页面上再加一个不产生任何额外开销。整个套件就是为组合而设计的。