GS1 Digital Link: Resolution
Total Page:16
File Type:pdf, Size:1020Kb
GS1 Digital Link: Resolution Resolving GS1 Digital Link URIs to one or more sources of related informationenabling consistent representation of GS1 identification keys within web addresses to link to online information and services To Be 1.2, Draft 0.6, 22 October 2020 GS1 Digital Link Standard Document Summary Document Item Current Value Document Name GS1 Digital Link: resolution Document Date 22 October 2020 Document Version To be 1.2 Document Issue Document Status Draft Document Description enabling consistent representation of GS1 identification keys within web addresses to link to online information and services Contributors (to be updated by Greg) Log of Changes Release Date of Change Changed By Summary of Change 0.1 2020-04-20 Phil Archer, Mark Harrison Preparation for work on version 1.2 (by editing version 1.1). Known specific issues are highlighted where relevant in the text. 0.2 2020-05-14 Phil Archer, Ralph Tröger Additional issues from RT: https for canonical URIs, identification of split in GRAIs; place holders for expected work on binary EPC/RFID 0.3 2020-08-07 Phil Archer Split from original all in one standard. Signifiant changes to matching of link attributes to requests 0.4 2020-10-02 Dom Guinard, Phil Archer Responding to Dom’s comments and MSWG meeting 2020-10-01 0.5 2020-10-14 Phil Archer Further responses to comments received from Dom and Frits van den Bos, tidying up of refs and glossary, introductory material added with links to other DL standards. 0.6 2020-10-22 Phil Archer Removed schema.org as a namespace that SHOULD be supported Disclaimer GS1®, under its IP Policy, seeks to avoid uncertainty regarding intellectual property claims by requiring the participants in the Work Group that developed this GS1 Digital Link: Resolution standard version 1.2 to agree to grant to GS1 members a royalty-free licence or a RAND licence to Necessary Claims, as that term is defined in the GS1 IP Policy. Furthermore, attention is drawn to the possibility that an implementation of one or more features of this Specification may be the subject of a patent or other intellectual property right that does not involve a Necessary Claim. Any such patent or other intellectual property right is not subject to the licencing obligations of GS1. Moreover, the agreement to grant licences provided under the GS1 IP Policy does not include IP rights and any claims of third parties who were not participants in the Work Group. To be version 1.2, Draft 0.6, 22 October 2020 © 2020 GS1 AISBL Page 2 of 47 GS1 Digital Link Standard Accordingly, GS1 recommends that any organisation developing an implementation designed to be in conformance with this Specification should determine whether there are any patents that may encompass a specific implementation that the organisation is developing in compliance with the Specification and whether a licence under a patent or other intellectual property right is needed. Such a determination of a need for licencing should be made in view of the details of the specific system designed by the organisation in consultation with their own patent counsel. THIS DOCUMENT IS PROVIDED “AS IS” WITH NO WARRANTIES WHATSOEVER, INCLUDING ANY WARRANTY OF MERCHANTABILITY, NONINFRINGEMENT, FITNESS FOR PARTICULAR PURPOSE, OR ANY WARRANTY OTHER WISE ARISING OUT OF THIS SPECIFICATION. GS1 disclaims all liability for any damages arising from use or misuse of this document, whether special, indirect, consequential, or compensatory damages, and including liability for infringement of any intellectual property rights, relating to use of information in or reliance upon this document. GS1 retains the right to make changes to this document at any time, without notice. GS1 makes no warranty for the use of this document and assumes no responsibility for any errors which may appear in the document, nor does it make a commitment to update the information contained herein. GS1 and the GS1 logo are registered trademarks of GS1 AISBL. To be version 1.2, Draft 0.6, 22 October 2020 © 2020 GS1 AISBL Page 3 of 47 GS1 Digital Link Standard Table of Contents 1 Introduction ................................................................................................ 6 1.1 How the GS1 Digital Link standard documents fit together ................................................... 6 1.2 Typographical conventions used in this document ............................................................... 7 2 Definitions and namespaces ........................................................................ 7 3 Conformance to GS1 Digital Link ................................................................. 7 4 Resolving GS1 Digital Link URIs .................................................................. 8 4.1 Core resolver functionality ............................................................................................... 8 4.2 Decompression .............................................................................................................. 12 4.3 Validation ..................................................................................................................... 12 4.3.1 Validation detail .................................................................................................... 13 4.4 Link attributes – what the resolver needs to know ............................................................. 15 4.4.1 The target URL ...................................................................................................... 15 4.4.2 The link relation type (link type) ............................................................................. 16 4.4.3 A title for the link .................................................................................................. 16 4.4.4 The human language of the linked resource .............................................................. 17 4.4.5 The Media Type for the content ............................................................................... 17 4.4.6 The context .......................................................................................................... 17 4.4.7 Additional attributes .............................................................................................. 17 4.5 Associating links with identified items ............................................................................... 17 4.5.1 The default link ..................................................................................................... 18 4.5.2 The default link for granular identifiers ..................................................................... 18 4.6 Resolution and Redirection .............................................................................................. 19 4.6.1 The default response ............................................................................................. 19 4.6.2 Requesting a specific link type ................................................................................ 20 4.6.3 Matching request parameters with link attributes ...................................................... 20 4.7 Examples ...................................................................................................................... 22 4.8 Pattern-based redirection to an alternative resolver ........................................................... 25 4.9 Requesting the linkset .................................................................................................... 25 4.9.1 The linkset formatted as HTTP Link headers .............................................................. 26 4.9.2 The linkset as JSON ............................................................................................... 27 4.9.3 The linkset as JSON-LD .......................................................................................... 29 4.10 Default link type may be set to linkset.............................................................................. 32 4.11 Handling the query string ............................................................................................... 33 4.12 Providing content directly ............................................................................................... 33 4.13 Supported link relation types .......................................................................................... 33 4.14 Link type maintenance ................................................................................................... 35 4.15 Resolver description file .................................................................................................. 35 4.15.1 JSON schema ........................................................................................................ 37 4.15.2 Example ............................................................................................................... 37 4.16 Conformance statement ................................................................................................. 38 4.17 GS1 Class Two resolver .................................................................................................. 39 5 Glossary .................................................................................................... 40 To be version 1.2, Draft 0.6, 22 October 2020 © 2020 GS1 AISBL Page 4 of 47 GS1 Digital Link Standard 6 Change log ................................................................................................ 43 7 References ...............................................................................................