Skip to main content

Link Types

The TrackVision GS1 Digital Link resolver supports two link types that control what a user or system receives when they access a product URL.

Resolver URL Format​

The base resolver URL for a product uses its GTIN in GS1 Digital Link format:

https://resolver.{domain}/01/{gtin}

With a serial number:

https://resolver.{domain}/01/{gtin}/21/{serial}

With a lot/batch number:

https://resolver.{domain}/01/{gtin}/10/{lot}

Examples:

https://resolver.acme.trackvision.ai/01/09506000134352
https://resolver.acme.trackvision.ai/01/09506000134352/21/SN-001
https://resolver.acme.trackvision.ai/01/09506000134352/10/BATCH-2024-01

gs1:pip — Product Information Page (Default)​

When a consumer scans a QR code with a standard camera app, the resolver serves gs1:pip behavior by default:

  • Trigger: Any HTTP request without a linkType parameter or Accept: application/ld+json header
  • Response: HTTP 302 redirect to the product information page
  • Destination: The AI-generated product website URL
# Consumer scans QR code — gets redirected to the product page
curl -L https://resolver.acme.trackvision.ai/01/09506000134352
# → HTTP 302 → https://products.acme.com/organic-cotton-tshirt

gs1:dpp — Digital Product Passport​

When a regulator, auditor, or system requests the DPP explicitly, the resolver returns the JSON-LD Verifiable Credential:

  • Trigger: ?linkType=gs1:dpp query parameter, OR Accept: application/ld+json header
  • Response: HTTP 200 with the signed DPP JSON-LD document
  • Content-Type: application/ld+json
# Request the DPP via linkType parameter
curl "https://resolver.acme.trackvision.ai/01/09506000134352?linkType=gs1:dpp"

# Request the DPP via Accept header
curl https://resolver.acme.trackvision.ai/01/09506000134352 \
  -H "Accept: application/ld+json"

Both return the same signed JSON-LD DPP document.

/itemtrace Endpoint​

For structured programmatic access to DPP data without the Verifiable Credential envelope, use the /itemtrace endpoint:

GET /itemtrace?gtin={gtin}
GET /itemtrace?gtin={gtin}&serial={serial}
GET /itemtrace?gtin={gtin}&lot={lot}

This endpoint returns the raw DPP data as a plain JSON object without the JSON-LD Verifiable Credential wrapper — useful for building dashboards or data pipelines that don't need cryptographic verification.

curl "https://resolver.acme.trackvision.ai/itemtrace?gtin=09506000134352"

The resolver also serves a link set document listing all available link types for a product:

curl "https://resolver.acme.trackvision.ai/01/09506000134352" \
  -H "Accept: application/linkset+json"

Response:

{
  "linkset": [
    {
      "anchor": "https://resolver.acme.trackvision.ai/01/09506000134352",
      "gs1:pip": [{ "href": "https://products.acme.com/organic-cotton-tshirt" }],
      "gs1:dpp": [{ "href": "https://resolver.acme.trackvision.ai/01/09506000134352?linkType=gs1:dpp" }]
    }
  ]
}