API Documentation — IIIF GLAM

GET IIIF Presentation API v2 & v3

/manifests/{identifier} auth

Manifest IIIF v2. Ajouter ?version=3 pour v3.

Ex : /manifests/photos--Campus_de_Nice.jpg

Tester Discovery →

/manifests/collection/{nom} auth

Collection IIIF d'un fonds.

Collections : photos · manuscrits · cartes · peintures · videos · archives · all

/manifests/recent auth

10 derniers documents. Paramètre optionnel : ?limit=N

/manifests/featured auth

Un document représentatif par collection.

/manifests/export/{identifier} auth

Télécharge le manifest v3 en JSON.

GET /manifests/photos--Campus_de_Nice.jpg?version=3
Authorization: Bearer {token}

{
  "@context": "http://iiif.io/api/presentation/3/context.json",
  "id": "https://iiif-glam.tech/manifests/photos--Campus_de_Nice.jpg",
  "type": "Manifest",
  "label": { "fr": ["Campus de Nice"] }
}

GET IIIF Content Search API v1

/search?q={terme} auth

Recherche plein texte dans les annotations.

Params : q · motivation · canvas · page

Nécessite un token JWT — utilisable via le viewer

/search/autocomplete?q={terme} auth

Suggestions depuis les tags des annotations.

GET /search?q=nice
Authorization: Bearer {token}

{
  "@context": "http://iiif.io/api/search/1/context.json",
  "@type": "sc:AnnotationList",
  "within": { "total": 7 },
  "resources": [{ "@type": "oa:Annotation", ... }]
}

GET IIIF Change Discovery API v1

/discovery public

OrderedCollection — flux Activity Streams de tous les changements.

Tester →

/discovery/page/{n} public

Page N du flux. 100 items par page.

Page 0 →

GET /discovery

{
  "@context": "http://iiif.io/api/discovery/1/context.json",
  "type": "OrderedCollection",
  "totalItems": 33,
  "first": { "id": ".../discovery/page/0", "type": "OrderedCollectionPage" }
}

GET IIIF Auth API v1

/auth/iiif/login public

Redirige vers Keycloak pour authentification OIDC/PKCE.

/auth/iiif/token public

Token IIIF depuis cookie kc_token. Compatible postMessage.

/auth/iiif/logout public

Déconnexion et suppression du cookie.

GET /auth/iiif/token
Cookie: kc_token={jwt}

{
  "@context": "http://iiif.io/api/auth/1/context.json",
  "accessToken": "eyJhbGci...",
  "expiresIn": 1800
}

GET Web Annotation API (W3C)

/annotations/canvas?canvas_id={id} auth

Liste les annotations d'un canvas IIIF.

/annotations auth POST

Crée une annotation W3C sur un canvas.

POST /annotations
Authorization: Bearer {token}

{
  "canvas_id": "https://iiif-glam.tech/manifests/photos--X/canvas/1",
  "body": { "type": "TextualBody", "value": "Mon annotation", "format": "text/plain" },
  "motivation": "commenting"
}