Skip to main content
The Closient Resolver implements the GS1 Digital Link standard, enabling any GTIN to be resolved to structured product data via a standard URI format. Resolution behavior is configurable through rules that support time-based routing, scope hierarchy, and custom destinations.

​
URI Format

A GS1 Digital Link URI encodes a primary identifier and optional qualifiers as path segments:

​
Supported Application Identifiers

​
Content Negotiation

The resolver returns different formats based on the Accept header:

​
Resolution Rules

Resolution behavior is controlled through rules configured per organization. Rules determine where a Digital Link request is routed.

​
Scope Hierarchy

Rules are evaluated from most specific to least specific scope. The first matching rule wins: Within each scope, rules are ordered by order_index (lower = higher priority).

​
Destination Types

For custom URLs, configure fallback behavior when the URL is unreachable:
  • Skip rule — evaluate the next rule in priority order
  • Fallback to hosted — use the Closient hosted page instead
Custom URL health is monitored automatically with consecutive failure tracking.

​
Time-Based Routing

Rules support time criteria for conditional routing (all criteria are AND-ed when present): Time criteria use the organization’s configured routing timezone (IANA format, e.g., America/New_York). Rules can be scoped to specific GS1 link types:

​
GS1 Conformance

The Closient Resolver is designed to conform to the GS1 Digital Link standard, including proper handling of Accept headers, Link response headers, and linkset JSON format. A built-in conformance test suite is available for validation. See the Resolver API reference for full endpoint documentation.