Trabaje con la API de Imágenes de IIIF

Trabaje con la API de Imágenes de IIIF

CONTENTdm utiliza la API de Imágenes IIIF para construir su visualización de imágenes predeterminada. A continuación se presentan dos ejemplos de registros de imágenes de CONTENTdm, uno de un sitio que utiliza el servidor de imágenes Cantaloupe y el otro de un sitio que utiliza el servidor de imágenes antiguo.  Haga clic en el botón de doble flecha diagonal en la esquina superior derecha de la imagen para ver el visor:

• Documento en el sitio de Cantaloupe: https://sandbox.contentdm.oclc.org/digital/collection/coll16/id/357
• Documento en un sitio que no es Cantaloupe: https://cdm17328.contentdm.oclc.org/digital/collection/oclcsample/id/64

Para verificar que una imagen de CONTENTdm sea compatible con la API de imagen IIIF, se puede realizar una solicitud para obtener un documento JSON que proporcione información sobre la imagen, incluyendo el ancho, la altura y la información de escala. Los patrones de URL de información de imagen de CONTENTdm siguen la especificación de la API de imagen de IIIF, pero difieren ligeramente según si el sitio de CONTENTdm está en el servidor de imágenes de Cantaloupe o no:

• Sitio Cantaloupe: yourCONTENTdmURL/digital/iiif/2/{collection alias}:{record ID}/info.json
• Sitio no Cantaloupe: yourCONTENTdmURL/digital/iiif/{collection alias}/{record ID}/info.json

Para el registro de ejemplo mencionado anteriormente, el "info.json" La URL es:

• Sitio de Cantaloupe: https://sandbox.contentdm.oclc.org/digital/iiif/2/coll16:357/info.json
• Sitio no Cantaloupe: https://cdm17328.contentdm.oclc.org/digital/iiif/oclcsample/64/info.json

La API de Imágenes de IIIF es un servicio potente y flexible para la interacción con imágenes digitales. Por ejemplo, aquí tiene una solicitud para generar un archivo JPEG de la imagen completa al 15 % de zoom:

• Sitio de Cantalupo: https://sandbox.contentdm.oclc.org/digital/iiif/2/coll16:357/full/pct:15/0/default.jpg
• Sitio no relacionado con Cantaloupe: https://cdm17328.contentdm.oclc.org/digital/iiif/oclcsample/64/full/pct:15/0/default.jpg

Aquí hay otra solicitud, mostrando un detalle seleccionado de la imagen completa:

• Sitio de Cantalupo: https://sandbox.contentdm.oclc.org/digital/iiif/2/coll16:357/1500,1000,1200,1400/pct:15/0/default.jpg
• Sitio no relacionado con Cantaloupe: https://cdm17328.contentdm.oclc.org/digital/iiif/oclcsample/64/1500,1000,1200,1400/pct:15/0/default.jpg

Aquí tiene un ejemplo más que muestra la imagen redimensionada para usarla como miniatura:

• Sitio de Cantalupo: https://sandbox.contentdm.oclc.org/digital/iiif/2/coll16:357/full/150,/0/default.jpg
• Sitio no relacionado con el melón cantalupo: https://cdm17328.contentdm.oclc.org/digital/iiif/oclcsample/64/full/150,/0/default.jpg

Para más información sobre estos y otros métodos para llamar al servicio de la API de imagen IIIF de CONTENTdm, consulte la especificación de la API de imagen IIIF.

Encuentre su tipo de servidor de imágenes

Su experiencia con el uso de la API de imágenes de IIIF será diferente dependiendo de si su sitio se ha trasladado al servidor de imágenes de Cantaloupe o si su sitio está en el servidor de imágenes heredado. Si no sabe si su sitio de CONTENTdm está en el servidor de imágenes Cantaloupe, siga los pasos a continuación para probarlo.

1. Intente acceder a la siguiente URL: yourCONTENTdmURL/iiif/manifest.json
   1. Está en el servidor Cantaloupe si la URL se resuelve y es dirigido automáticamente a: yourCONTENTdmURL/iiif/2/manifest.json
   2. Usted está en el servidor heredado si la URL no se resuelve.

Utilizando el ejemplo anterior, podrá ver los diferentes comportamientos de los dos tipos de sitios:

• Documento en el sitio de Cantaloupe: https://sandbox.contentdm.oclc.org/iiif/manifest.json
• Documento en un sitio que no es Cantaloupe: https://cdm17328.contentdm.oclc.org/iiif/manifest.json