{"id":1286,"date":"2020-06-04T15:30:27","date_gmt":"2020-06-04T13:30:27","guid":{"rendered":"https:\/\/lab.ub.uni-leipzig.de\/?page_id=1286"},"modified":"2020-07-22T11:32:54","modified_gmt":"2020-07-22T09:32:54","slug":"iiif-apis","status":"publish","type":"page","link":"https:\/\/lab.ub.uni-leipzig.de\/en\/daten-und-schnittstellen\/iiif-apis\/","title":{"rendered":"IIIF"},"content":{"rendered":"Leip\u00adzig Uni\u00adver\u00adsi\u00adty Libra\u00adry (UBL) pro\u00advi\u00addes access to its high-qua\u00adli\u00adty digi\u00adti\u00adsed mate\u00adri\u00adal accor\u00adding to the API stan\u00addards of the Inter\u00adna\u00adtio\u00adnal Image Inter\u00adope\u00adra\u00adbi\u00adli\u00adty Frame\u00adwork<\/a> (IIIF). This is a modern stan\u00addard based on JSON-LD.\n

The IIIF APIs are par\u00adti\u00adcu\u00adlar\u00adly well sui\u00adted for inte\u00adgra\u00adting UBL image con\u00adtent direct\u00adly into your own web\u00adsites, appli\u00adca\u00adti\u00adons and apps wit\u00adhout having to copy or edit the images. With IIIF, an inter\u00adface is available that allows you to dyna\u00admi\u00adcal\u00adly access UBL\u2019s rich data coll\u00adec\u00adtions from your own applications.<\/p>\n

Fol\u00adlo\u00adwing the spe\u00adci\u00adfi\u00adca\u00adti\u00adons of IIIF, the UBL\u2019s hol\u00addings are hier\u00adar\u00adchi\u00adcal\u00adly divi\u00added into coll\u00adec\u00adtions, biblio\u00adgra\u00adphic units are repre\u00adsen\u00adted by mani\u00adfests. Both are done accor\u00adding to the spe\u00adci\u00adfi\u00adca\u00adti\u00adons of the IIIF Pre\u00adsen\u00adta\u00adti\u00adon API. From the mani\u00adfests, access to the actu\u00adal digi\u00adti\u00adzed mate\u00adri\u00adal is pos\u00adsi\u00adble accor\u00adding to the spe\u00adci\u00adfi\u00adca\u00adti\u00adons of the IIIF Image API.<\/p>\n

At this time the UBL sup\u00adports ver\u00adsi\u00adon 2 of the IIIF API stan\u00addards. For a descrip\u00adti\u00adon of all func\u00adtions of the APIs plea\u00adse read the descrip\u00adti\u00adons on https:\/\/iiif.io<\/a><\/p>\n

Collections<\/h2>\n

You can access UBL\u2019s data sets via the coll\u00adec\u00adtions on the top level:<\/p>\n

https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/toplevel.json<\/a><\/p>\n

{\n  \"@context\" : \"http:\/\/iiif.io\/api\/presentation\/2\/context.json\",\n  \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/toplevel.json\",\n  \"@type\" : \"sc:Collection\",\n  \"label\" : \"IIIF Collection for Leipzig University Library\",\n  \"description\" : \"Collection for all IIIF manifests which are produced by the Leipzig University Library.\",\n  \"collections\" : [ {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/Drucke16\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Drucke des 16. Jahrhunderts\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/LeipzigerVerlage\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Leipziger Verlage\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/Drucke17\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Drucke des 17. Jahrhunderts\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/Buchhandschriften\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Buchhandschriften\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/MittelalterHandschriften\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Abendl\u00e4ndische mittelalterliche Handschriften\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/NachlassWustmann\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Nachlass Wustmann - Autographensammlung Wustmann [NL 297\/4]\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/Drucke15\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Drucke des 15. Jahrhunderts\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/Drucke19\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Drucke des 19. Jahrhunderts\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/GriechischeHandschriften\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Griechische Handschriften\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/Drucke20\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Drucke des 20. Jahrhunderts\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/AbendNeuzeitHandschriften\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Abendl\u00e4ndische neuzeitliche Handschriften\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/Drucke18\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Drucke des 18. Jahrhunderts\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  }, {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/NeuzeitHandschriften\/collection.json\",\n    \"@type\" : \"sc:Collection\",\n    \"label\" : \"Neuzeitliche Handschriften\",\n    \"attribution\" : \"Provided by Leipzig University Library\",\n    \"logo\" : {\n      \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n      \"format\" : \"image\/png\"\n    }\n  } ],\n  \"attribution\" : \"Provided by Leipzig University Library\",\n  \"logo\" : {\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/ubl-logo.png\",\n    \"format\" : \"image\/png\"\n  }\n}\n<\/pre>\n
Sub\u00ador\u00addi\u00adna\u00adte coll\u00adec\u00adtions are lin\u00adked in JSON and can be tracked :<\/p>\n
https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/Buchhandschriften\/collection.json<\/a><\/p>\n
{\n  \"@context\" : \"http:\/\/iiif.io\/api\/presentation\/2\/context.json\",\n  \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/static\/collections\/Buchhandschriften\/collection.json\",\n  \"@type\" : \"sc:Collection\",\n  \"label\" : \"Buchhandschriften\",\n  \"manifests\" : [ {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000003244\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Fragm. lat. 53\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000003909\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Fragm. lat. 424\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000004134\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Ms 671\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000004357\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Ms 1529\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000003895\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Fragm. lat. 400\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000003630\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Fragm. lat. 335\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000004473\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Fragm. Civ. Lips. 1\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000003163\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Fragm. lat. 21\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000002958\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Ms 96\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000005430\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Rep. II 120 (Leihgabe Leipziger Stadtbibliothek)\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000003262\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Fragm. lat. 56\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000004611\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Ms 1311\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000004626\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Ms 1574\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000001780\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Ms 150\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000004574\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Ms 1313\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000003670\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Fragm. lat. 339\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000004470\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Ms 1033\"\n  }, {\n    \"@type\" : \"sc:Manifest\",\n    \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/0000004604\/manifest.json\",\n    \"label\" : \"Leipzig, Universit\u00e4tsbibliothek Leipzig, Ms 412\"\n  }]}\n<\/pre>\n
Manifests<\/h2>\n
Coll\u00adec\u00adtions at the lowest level refer to the mani\u00adfests of the biblio\u00adgra\u00adphic units assi\u00adgned to them. The\u00adse can also be retrie\u00adved via HTTPS.<\/p>\n
https:\/\/iiif.ub.uni-leipzig.de\/0000004604\/manifest.json<\/a><\/p>\n
<\/pre>\n
Images<\/h2>\n
The mani\u00adfests con\u00adtain refe\u00adren\u00adces to the inter\u00adfaces of the IIIF Image API:<\/p>\n
https:\/\/iiif.ub.uni-leipzig.de\/iiif\/j2k\/0000\/0046\/0000004604\/00000084.jpx<\/p>\n
The IIIF Image API is ide\u00adal for inte\u00adgra\u00adting digi\u00adtal image con\u00adtent direct\u00adly into other appli\u00adca\u00adti\u00adons. Near\u00adly all digi\u00adti\u00adzed mate\u00adri\u00adal of the UBL is made available under open licen\u00adses<\/a> and can thus be used in sci\u00aden\u00adti\u00adfic, artis\u00adtic and also com\u00admer\u00adcial projects.<\/p>\n
By appen\u00adding the string \u201cinfo.json\u201d the infor\u00adma\u00adti\u00adon about the respec\u00adti\u00adve digi\u00adti\u00adsed mate\u00adri\u00adal can be obtai\u00adned accor\u00adding to the IIIF Image API.<\/p>\n
https:\/\/iiif.ub.uni-leipzig.de\/iiif\/j2k\/0000\/0046\/0000004604\/00000084.jpx\/info.json<\/a><\/p>\n
{\n  \"@context\" : \"http:\/\/iiif.io\/api\/image\/2\/context.json\",\n  \"@id\" : \"https:\/\/iiif.ub.uni-leipzig.de\/fcgi-bin\/iipsrv.fcgi?iiif=\/j2k\/0000\/0046\/0000004604\/00000084.jpx\",\n  \"protocol\" : \"http:\/\/iiif.io\/api\/image\",\n  \"width\" : 3840,\n  \"height\" : 5760,\n  \"tiles\" : [\n     { \"width\" : 256, \"height\" : 256, \"scaleFactors\" : [ 1, 2, 4, 8, 16, 32 ] }\n  ],\n  \"profile\" : [\n     \"http:\/\/iiif.io\/api\/image\/2\/level1.json\",\n     { \"formats\" : [ \"jpg\" ],\n       \"qualities\" : [ \"native\",\"color\",\"gray\" ],\n       \"supports\" : [\"regionByPct\",\"sizeByForcedWh\",\"sizeByWh\",\"sizeAboveFull\",\"rotationBy90s\",\"mirroring\",\"gray\"] }\n  ]\n}\n<\/pre>\n
Accor\u00adding to the API spe\u00adci\u00adfi\u00adca\u00adti\u00adon, the actu\u00adal image data can now be acces\u00adsed. The who\u00adle image in maxi\u00admum reso\u00adlu\u00adti\u00adon and qua\u00adli\u00adty can be obtai\u00adned by appen\u00adding the string \/full\/full\/0\/default.jpeg:<\/p>\n
https:\/\/iiif.ub.uni-leipzig.de\/iiif\/j2k\/0000\/0046\/0000004604\/00000084.jpx\/full\/full\/0\/default.jpg<\/a><\/p>\n
Howe\u00adver, the image data can also be deli\u00adver\u00aded sca\u00adled by the ser\u00adver. Here is an exam\u00adp\u00adle, sca\u00adled to 300 pixels height.<\/p>\n
https:\/\/iiif.ub.uni-leipzig.de\/iiif\/j2k\/0000\/0046\/0000004604\/00000084.jpx\/full\/,300\/0\/default.jpg<\/a><\/p>\n
\"Full<\/p>\n
Ins\u00adtead of the com\u00adple\u00adte image, the IIIF ser\u00adver can also pro\u00advi\u00adde image details. Here for exam\u00adp\u00adle an image sec\u00adtion with coor\u00addi\u00adna\u00adtes x=1050, y=500, w=900, h=900, sca\u00adled to 200 pixels width.<\/p>\n
https:\/\/iiif.ub.uni-leipzig.de\/iiif\/j2k\/0000\/0046\/0000004604\/00000084.jpx\/1050,500,900,900\/200,\/0\/default.jpg<\/a><\/p>\n
\"Image<\/p>\n
The image sec\u00adtion can also be dis\u00adplay\u00aded in rota\u00adted form (90 degrees clockwise).<\/p>\n
https:\/\/iiif.ub.uni-leipzig.de\/iiif\/j2k\/0000\/0046\/0000004604\/00000084.jpx\/1050,500,900,900\/200,\/90\/default.jpg<\/a><\/p>\n
\"image<\/p>\n
And deli\u00adverd in grayscale.<\/p>\n
https:\/\/iiif.ub.uni-leipzig.de\/iiif\/j2k\/0000\/0046\/0000004604\/00000084.jpx\/1050,500,900,900\/200,\/90\/grey.jpg<\/a><\/p>\n
\"Same<\/p>\n
More detail\u00aded infor\u00adma\u00adti\u00adon about the IIIF APIs can be found on the web\u00adsite https:\/\/iiif.io<\/a>.<\/p>\n
If you have any ques\u00adti\u00adons about the use of our APIs or if you would like to imple\u00adment IIIF APIs yours\u00adelf, plea\u00adse cont\u00adact us<\/a>.<\/p>\n
Further information<\/h2>\n
We have sum\u00adma\u00adri\u00adzed our offers to end users on the basis of the IIIF APIs in a sepa\u00adra\u00adte artic\u00adle<\/a>.<\/p>\n
Much more infor\u00adma\u00adti\u00adon about the IIIF API stan\u00addards can be found on the web\u00adsite https:\/\/iiif.io<\/a><\/p>\n
A list of exem\u00adpla\u00adry appli\u00adca\u00adti\u00adons, frame\u00adworks and the like is main\u00adtai\u00adned here: https:\/\/github.com\/IIIF\/awesome-iiif<\/a><\/p>\n
A sel\u00adec\u00adtion of other IIIF Coll\u00adec\u00adtions can be found here: https:\/\/github.com\/ryanfb\/iiif-universe\/blob\/gh-pages\/iiif-universe.json<\/a>\n<\/p>