Authority ID lookup service - scriptotek/almar GitHub Wiki

Almar can check terms against an authority ID service. The service must accept the GET parameters:

• vocabulary: the MARC vocabulary code
• term: the term to authorize
• tag: the MARC tag: 600, 610, 611, 650 or other. Can be used to determine the concept type.

Example request:

http://example.com/id?vocabulary=noubomn&term=Diagrambasert+resonnering&tag=650

Success response:

If the vocabulary + tag + term combination matches exactly one concept, the service should return a JSON object with the ID.

Example response:

{
  "id": "(NO-TrBIB)REAL031878"
}

Note that the parenthesis prefix should be included if it should be added to the record.

Error response

If the vocabulary + tag + term combination matches no concepts or more than one concept, the service should return a JSON object with some error message.

Example response:

{
  "error": "Term matched more than one concept."
}