Home

Image API Compliance, 1.1

Table of Contents

  1. Introduction
  2. Compliance Level Summary
  3. Level 0 Compliance
  4. Level 1 Compliance
  5. Level 2 Compliance

1. Introduction To TOC

This document is a companion to the International Image Interoperability Framework Image API Specification. It defines the set of supported parameters that correspond to different levels of compliance to the IIIF Image API.

2. Compliance Level Summary To TOC

Three levels of compliance are defined. Level 0 is defined as the minimum set of supported parameters and features to qualify an implementation of the service as compliant to the IIIF standard. Level 1 is defined as the RECOMMENDED set of parameters and features to be implemented.

Level 0 Level 1 Level 2 Optional
Region
full
x,y,w,h
pct:x,y,w,h
Size
full
w,
,h
pct:x
w,h
!w,h
Rotation
0
90,180,270
arbitary
Quality
native
color
grey
bitonal
Format
jpg
png
tif
gif
pdf
jp2
Image Information Request
JSON response
Level 0 Level 1 Level 2 Optional

3. Level 0 Compliance To TOC

Servers indicate compliance with level 0 by including the following header in IIIF responses:

Link: <http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level0>;rel="profile"

A level 0 compliant image server MAY specify scaling_factors and/or tile_width and tile_height values in the Image information response. At Level 0 compliance, a server is only required to deliver images of sizes computed using the scaling factors declared in the Image Information response. If specified they should be interpreted with the following special meanings:

  • scaling_factors - only the specified scaling factors are supported
  • tile_width, tile_height - clients should request only regions that correspond to output tiles of the specified dimensions

If a client requests an scaling or region outside these parameters then the image server MAY reject the request with a 400 Bad Request error.

4. Level 1 Compliance To TOC

Servers indicate compliance with level 1 by including the following header in IIIF responses:

Link: <http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level1>;rel="profile"

5. Level 2 Compliance To TOC

Servers indicate compliance with level 2 by including the following header in IIIF responses:

Link: <http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level2>;rel="profile"