⬡

GS1 Digital Link Resolver

Context-aware resolution of GS1 Digital Link URIs

GS1 Conformantv1.2.0

Overview

This resolver translates GS1 Digital Link URIs into target URLs based on configurable mappings and user context (device type). It implements the GS1-Conformant Resolver Standard.

URI Format

The resolver accepts GS1 Digital Link URIs with the following Application Identifiers:

AINameExample

01GTIN09520123456788

10Batch/LotABC123

21Serial12345

17Expiry Date261231

Example Requests

Basic GTIN Resolution

GET https://resolver.example.com/01/09520123456788

→ 307 Redirect to configured target

GTIN with Batch/Lot

GET https://resolver.example.com/01/09520123456788/10/ABC123

→ 307 Redirect to traceability target

GTIN with Serial Number

GET https://resolver.example.com/01/09520123456788/21/12345

→ 307 Redirect to verification target

JSON Response (Debug Mode)

GET https://resolver.example.com/01/09520123456788
Accept: application/json

{
  "resolved": true,
  "targetUrl": "https://catalog.example.com/product/09520123456788",
  "matched": true,
  "gs1Data": {
    "gtin": "09520123456788",
    "isValid": true
  },
  "context": {
    "deviceType": "desktop"
  }
}

Context-Aware Routing

The resolver detects the device type from the User-Agent header and routes to different targets accordingly:

Mobile: iOS, Android, and other mobile devices
Desktop: Standard desktop browsers
Bot: Search engine crawlers and social media bots