Foreword

For the PIA research project, we would like to have, as much as possible, consistent URI schemas. For this purpose, we set up quite a few sub-domains (as shown in the table below).

Type	URI example
Digital representation of an object (with content negotiation)	https://participatory-archives.ch/s/explore/<entity>/<ID>
PIA Omeka S API	https://participatory-archives.ch/api/items/<ID>
PIA JSON API (Legacy)	https://json.participatory-archives.ch/api/v1/entity/<ID>
Linked Art API	https://data.participatory-archives.ch/entity/<ID>
IIIF Image API	https://sipi.participatory-archives.ch/<collection>/<ID>/info.json
IIIF Presentation API (Manifest)	https://iiif.participatory-archives.ch/<ID>/manifest.json
IIIF Presentation API (Collection)	https://iiif.participatory-archives.ch/collections/<ID>.json
Controlled Vocabularies	https://vocab.participatory-archives.ch/vocabulary/<ID>
Project Website	https://project.participatory-archives.ch/

For Linked Art, we will try to follow the preferred endpoint path names for entities (with some tweaks for person and group as we will leverage agent instead)

To avoid link rot, we are going to leverage Archival Resource Keys (ARKs) as persistent identifiers.

PIA Archival Resource Keys (ARKs)

For the management of the PIA ARKs, the following parts are described in this repository:

• ARK Structure
• ARK Minter
• ARK Resolver
• Access persistence policy

Structure

General ARK Anatomy

                        Base Compact Name   Qualifiers
                           _________________  ___________
                          /                 \/           \
      https://example.org/ark:12345/x6np1wh8k/c3/s5.v7.xsl
              \_________/ \__/\___/\_/\_____/\____/\_____/
                 NMA     Label NAAN |  Blade Parts Variants
                                  Shoulder
                              \_____________/
                                 Check Zone

Main components of PIA ARKs

NMA and Base Compact Name	PIA
Name Mapping Authority (NMA)	https://ark.participatory-archives.ch/
Label	ark:
Name Assigning Authority Number (NAAN)	19156
Shoulder	A three-character prefix depending on sub-domains and entity types such as bnz (cf. below)
Blade	Object Identifier appended by a check character

PIA ARK Shoulders

Shoulder	Use	PIA (sub)-domain and entity
bnz	Object	https://participatory-archives.ch/object/
czn	Agent	https://participatory-archives.ch/agent/
ztf	Linked Art API Object	https://data.participatory-archives.ch/object/
ztg	Linked Art API Digital	https://data.participatory-archives.ch/digital/
zth	Linked Art API Person	https://data.participatory-archives.ch/person/
ztj	Linked Art API Group	https://data.participatory-archives.ch/group/
tkt	Vocabulary Term	https://vocab.participatory-archives.ch/
cpz	IIIF Image API	https://sipi.participatory-archives.ch/
rpz	IIIF Presentation API Resource	https://iiif.participatory-archives.ch/

Minter

TBD

Resolver

TBD

https://ark.participatory-archives.ch/ark:19156/bnz14759z as well as https://n2t.net/ark:19156/bnz14759z should redirect to https://participatory-archives.ch/images/14759

Access persistence policy

TBD

References

• The ARK Identifier Scheme
• Archival Resource Key Alliance
• Name Assigning Authority Number (NAAN) Registry
• Nice Opaque IDentifier (NOID)