Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Send an API key to the request as a bearer token in the Authorization header. Each unit will share an API key (see ENV['YPM_SECRET'] in the code below) with ITS.

An example in Ruby for creating the requestA curl example:

Code Block
languageruby
require 'net/http'

uri = URI(curl -O -H 'Authorization: Bearer TOKEN' 'http://images-dev.collections.yale.edu/iiif/2/ypm:85f1f218-30c1-48a4-8546-17d681f59c35.tif/full/20,/0/default.jpg')
api_key =

with TOKEN replaced with the actual value of the API key

An example in Ruby:

Code Block
languageruby
require 'net/http'

uri = URI('http://images-dev.collections.yale.edu/iiif/2/ypm:85f1f218-30c1-48a4-8546-17d681f59c35.tif/full/20,/0/default.jpg')
api_key = ENV['YPM_SECRET']

req = Net::HTTP::Get.new(uri)
req['Authorization'] = "Bearer #{api_key}"

res = Net::HTTP.start(uri.hostname, uri.port,
                      use_ssl: uri.scheme == 'https') do |http|
  http.request(req)
end

open('out.jpg', 'w') do |f|
  f.write(res.read_body)
end


Getting Stock TIFF Images

Code Block
https://media.collections.yale.edu/tiff/{unit}/{uuid}.tif

...

Code Block
{
  "unit": "YCBA",
  "cmsType": "obj",
  "cmsId": "1726",
  "metadata": [
    {
      "label": "logo",
      "value": "https://static.britishart.yale.edu/images/ycba_logo.jpg"
    },
    {
      "label": "label",
      "value": "Robert Dighton, 1752–1814, British, The Produce of Industry, undated"
    },
    {
      "label": "licenseRights URI",
      "value": "https://creativecommons.org/publicdomain/zero/1.0/"
    },
    {
      "label": "Rights Description",
      "value": "Metadata describing Yale Center for British Art collections is public domain under CC0. Copyright or other restrictions may apply to cultural works or images of those works in this record."
    },
     {
      "label": "Copyright Statement",
      "value": "Copyright Information"
    },
    {
      "label": "Image Use Rights URI",
      "value": "http://rightsstatements.org/vocab/UND/1.0/"
    },
    {
      "label": "Image Use Rights",
      "value": "Copyright Undetermined: The copyright and related rights status of this Item has been reviewed by the organization that has made the Item available, but the organization was unable to make a conclusive determination as to the copyright status of the Item. Please refer to the organization that has made the Item available for more information. You are "label": "Rights Description",
      "value": "Data are in public domain, but separate rights restrictions may apply to individual imagesfree to use this Item in any way that is permitted by the copyright and related rights legislation that applies to your use."
    },
    {
      "label": "Attribution",
      "value": "Yale Center for British Art, Paul Mellon Collection, public domain"
    },
    {
      "label": "Description",
      "value": "Twelve Illustrations to Contemporary Life and Diversions, Sheet: 6 5/8 × 10 7/8 inches (16.8 × 27.6 cm)"
    },
    {
      "label": "Creator",
      "value": "Robert Dighton, 1752–1814, British"
    },
    {
      "label": "Title",
      "value": "The Produce of Industry"
    },
    {
      "label": "Physical Description",
      "value": "Sheet: 6 5/8 × 10 7/8 inches (16.8 × 27.6 cm)"
    },
    {
      "label": "Credit Line",
      "value": "Yale Center for British Art, Paul Mellon Collection"
    },
    {
      "label": "Institution",
      "value": "Yale Center for British Art"
    },
    {
      "label": "Collection",
      "value": "Prints and Drawings"
    },
    {
      "label": "Call Number",
      "value": "B1986.29.81"
    },
    {
      "label": "homepage",
      "value": [
        {
          "@id": "https://collections.britishart.yale.edu/catalog/tms:1726",
          "type": "Text",
          "label": "catalog entry at the Yale Center for British Art",
          "format": "text/html"
        }
      ]
    },
    {
      "label": "seeAlso",
      "value": [
        {
          "@id": "https://collections.britishart.yale.edu/oaicatmuseum/OAIHandler?verb=GetRecord&identifier=oai:tms.ycba.yale.edu:1726&metadataPrefix=lido",
          "type": "Dataset",
          "format": "text/xml",
          "profile": "http://www.lido-schema.org/schema/v1.0/lido-v1.0.xsd"
        },
        {
          "@id": "http://collection.britishart.yale.edu/id/page/object/1726",
          "format": "text/rdf+n3"
        }
      ]
    }
  ]
}


...



unit, cmsType, cmsId

These three values together uniquely defines an object, corresponding respectively to unitcode, cmstype, and cmsid in the dbo.assets table of TMAN database.

metadata

  • An ordered list of items, each of which has a "label" and a "value".

  • All entries are optional, except "label", "logo", and "Attribution" are required.

  • Any combinations of “label” and “values” can be added here, and each item will be added to the top level “metadata” field of the manifest as it is, with the exception of the “special” labels below, which are interpreted differently.

label

becomes the “label” for the whole manifest

licenseRights URI

goes to the top level “rights” field

Rights Description

goes into the top level “requiredStatement” field

Copyright Statement

Image Use Rights URI

Image Use Rights

logo

goes to the top level “logo” field

homepage, seeAlso

goes to the top level “homepage”, “seeAlso” field respectively. Since these can have great variability among units, this field should be entered verbatim as should appear in the manifest, according to the API. See

...