The resolver

Every GS1 host KuikCode serves, the included gs1-....kuikco.de one or your branded subdomain, is a GS1 Digital Link resolver.

Phones

A scan is redirected to the destination you chose, the scan is recorded, UTM parameters are applied and Smart Rules are evaluated, exactly like any dynamic KuikCode. Every redirect also carries an RFC 8288 Link header listing the available link types.

Machines

Retailer and partner apps ask the same URL for its linkset instead of a redirect, in any of three ways:

• append ?linkType=all,
• send Accept: application/linkset+json,
• ask for one link type by name, ?linkType=gs1:pip, which redirects to that link.

The answer is an RFC 9264 linkset:

{
  "linkset": [
    {
      "anchor": "https://yourbrand.kuikco.de/01/09506000134352",
      "https://gs1.org/voc/defaultLink": [{ "href": "https://example.com/product" }],
      "https://gs1.org/voc/pip": [{ "href": "https://example.com/product", "title": "Product information" }]
    }
  ]
}

Today two link types are published, gs1:defaultLink and gs1:pip, both pointing at the phone destination. Linkset requests are not counted as scans. An access code on the code still applies.

Resolver description

GET https://yourhost/.well-known/gs1resolver describes the resolver: its root, the supported link type namespace (https://gs1.org/voc/, prefix gs1:) and primary keys (01), and that linkType=all is accepted.