-
Notifications
You must be signed in to change notification settings - Fork 1
Auto Generate @id
Jana Rajakumar edited this page Feb 21, 2018
·
3 revisions
The API will auto-generate the @id for an object if not provided or will transform the given @id to match the recommended pattern in the IIIF spec.
The @id will be parsed and transformed to match the IIIF_BASE_URL given in the app settings.
Although these are recommended patterns from the IIIF spec, our API strictly enforces these patterns. This allows us to perform the necessary transformations in a consistent manner.
IIIF Recommended URI Patterns: http://iiif.io/api/presentation/2.1/#a-summary-of-recommended-uri-patterns
| Resource | URI Pattern |
|---|---|
| Collection | {scheme}://{host}/{prefix}/collection/{name} |
| Manifest | {scheme}://{host}/{prefix}/{identifier}/manifest |
| Sequence | {scheme}://{host}/{prefix}/{identifier}/sequence/{name} |
| Canvas | {scheme}://{host}/{prefix}/{identifier}/canvas/{name} |
| Annotation | {scheme}://{host}/{prefix}/{identifier}/annotation/{name} |
| AnnotationList | {scheme}://{host}/{prefix}/{identifier}/list/{name} |
| Range | {scheme}://{host}/{prefix}/{identifier}/range/{name} |
| Layer | {scheme}://{host}/{prefix}/{identifier}/layer/{name} |
| Content | {scheme}://{host}/{prefix}/{identifier}/res/{name}.{format} |
- (Example):
- An
@idofhttp://example.org/iiif/book1/annotation/anno1will be transformed in tohttp://localhost/presentation/book1/annotation/anno1given that the value forIIIF_BASE_URLin the settings ishttp://localhost/presentation.