TL;DR
- GS1 Digital Link 解析器是 GS1 Digital Link 中域名背后的网络服务。它读取所扫描网址中的标识符,并把读取者引导到正确的目的地:产品页面、召回通知、使用手册或机器可读的数据。
- 它响应三类请求:普通扫描进入默认链接,请求特定链接类型时进入该链接,请求链接集时则返回它为该产品保存的所有链接。
- 解析器可以由品牌、GS1 成员组织、零售商或解决方案服务商运营。由于每个解析器都相互独立,又遵循同一项 GS1 标准,任何符合标准的应用都可以使用任何解析器。
GS1 Digital Link 解析器是一台网络服务器,它把 GS1 标识符(例如产品的 GTIN)与网上关于它的信息连接起来。当手机扫描 GS1 Digital Link 二维码时,请求会发送到该码域名上的解析器。解析器检查网址,找到为该产品、批次或单件商品存储的链接,并重定向到符合请求的那一个。正因如此,一个码才能为购物者、商业伙伴和系统分别提供不同的内容。
解析器一览
| 是什么 | 把 GS1 标识符解析为在线资源的网络服务器 |
| 输入 | 一个 GS1 Digital Link URI:域名、主键、限定符和属性 |
| 输出 | 重定向到某个目的地、一份链接列表,或一条说明为何没有目的地的错误信息 |
| 谁来运营 | 品牌、GS1 成员组织、零售商或解决方案服务商 |
| 标准 | GS1 关于符合标准的解析器的规范,与 GS1 Digital Link URI 语法配套 |
| 协议 | HTTPS,响应 GET、HEAD 和 OPTIONS 请求,并支持 CORS,以便网页应用查询 |
查询解析器的三种方式
| 请求 | 解析器的处理 | 典型读取者 |
|---|---|---|
| 普通扫描该网址 | 重定向到默认链接,通常是产品页面 | 购物者的手机 |
带有 linkType 参数的网址,例如 ?linkType=gs1:recallStatus | 如果有该类型的链接,就重定向到该链接 | 寻找特定内容的应用或商业伙伴 |
带有 linkType=linkset 的网址 | 以机器可读的格式,返回它为该标识符保存的完整链接列表 | 希望发现所有可用内容的系统和应用 |
链接还可以按语言和语境来选择。同一个码,可以把法国的购物者引导到法语页面,把德国的购物者引导到德语页面。
解析器如何处理每个请求
- 解压。 如果码采用了标准为小尺寸符号所允许的压缩形式,解析器会先把网址解压。
- 验证。 它检查语法:有效的 GS1 主键、顺序正确的键限定符,以及有效的数据属性。
- 查找。 它在自己所掌握的最具体层级(单件、批次或产品)上,查找为该标识符存储的链接。
- 选择。 它选出与请求相符的链接:默认链接、所请求的链接类型,或链接集。
- 响应。 它返回一个重定向、链接列表,或一条附有说明的错误信息。
每个链接存储的元数据
| 属性 | 是否必需 | 示例 |
|---|---|---|
| 目标网址 | 是 | 关于该产品的某个页面的地址,而不是首页或搜索结果 |
| 链接类型 | 是 | 产品信息页面,gs1:pip |
| 标题 | 是 | "产品信息",在应用列出可选项时显示 |
| 语言 | 否 | en、fr、de |
| 媒体类型 | 否 | 页面为 text/html,数据为 application/json |
| 语境 | 否 | 地区或用途,用于按市场路由 |
一个目标可以带有多个链接类型,用于一个页面承担多种角色的情况,例如同时显示过敏原信息的产品页面。
解析器如何应答
| 情形 | 响应 |
|---|---|
| 存在匹配的链接 | 重定向到该链接(307 Temporary Redirect),并在 HTTP Link 标头中提供链接集 |
| 该解析器没有相关信息,但其他解析器可能有 | 重定向到备选解析器(307) |
| 该解析器没有相关信息 | 404 Not Found |
| 该解析器知道自己为何无法处理该标识符 | 303 See Other,指向一份说明 |
| 网址格式错误 | 一条说明错误所在的错误响应 |
原始网址中的查询字符串值(例如有效期)在解析器重定向时会原样传递。每多一次重定向,扫描者的等待时间就会增加,因此解析器链应尽量短。
如何搭建 GS1 Digital Link 解析器:五个步骤
- 选择域名。 使用你自己的子域名,例如
id.yourbrand.com,无论由哪家服务商运营解析器,码都始终属于你,购物者也能在网址中看到你的品牌。 - 自行搭建或选用服务商。 只要有足够的时间和工程能力,任何人都可以搭建符合标准的解析器。服务商则可以提供一个开箱即用的解析器。无论哪种方式,都要确认它遵循 GS1 解析器标准,这样任何符合标准的应用都能读取你的码。
- 导入产品及其默认链接。 为每个 GTIN 添加默认目的地;在需要不同目的地的地方(例如召回),添加批次级或单件级条目。
- 添加链接类型、语言和语境。 为每个链接设置类型和标题,添加各语言版本,并在内容有差异的地方按市场路由。
- 测试每一条路径。 检查普通扫描、对每种链接类型的请求、链接集、未知的 GTIN 和格式错误的网址,然后在上线后监测扫描情况。码打不开时该检查什么,请参阅故障排查指南。
Digital Link 平台上的解析器
本网站背后的平台 Digital Link 为你的码运营一个符合 GS1 标准的解析器,可以使用平台自己的域名,也可以通过 CNAME 记录使用你的子域名。每个产品都有一个默认目的地,并提供按语言和国家区分的版本,以及针对批次或单件的变体。每个链接都可以随时更改,无需重新印刷。
常见问题
什么是 GS1 Digital Link 解析器?
GS1 Digital Link 中域名背后的网络服务。它读取所扫描网址中的标识符,找到为该产品、批次或单件商品存储的链接,并重定向到符合请求的目的地。
GS1 Digital Link 解析器由谁运营?
品牌、GS1 成员组织、零售商和解决方案服务商都可以运营。每个解析器都相互独立,而且由于它们遵循同一项 GS1 标准,应用可以查询其中任何一个。
什么是链接类型?
解析器可以为产品提供的一类目的地,例如产品信息页面 gs1:pip,或召回状态 gs1:recallStatus。应用通过请求某个链接类型来获取特定资源,而不是默认页面。
什么是链接集?
解析器为某个标识符保存的完整链接列表,当应用请求 linkType=linkset 时,以机器可读的格式返回。它让系统能够发现某个产品的所有可用信息。
我需要自己的解析器吗?
你的码背后需要一个符合标准的解析器,但不一定是你自己搭建的。大多数品牌使用服务商,并把码放在自己的子域名上,使码始终归自己所有。
收银台会用到解析器吗?
不会。支持 2D 的收银台直接从码中读取 GTIN、批号和有效期,无需联网。只有打开网址的手机和应用才会访问解析器。





