UnAPI

Fra Biblab

Gå til: navigasjon, søk

Enkel protokoll som gjør det mulig å knytte beskrivelser av "ting" på en web-side til maskinlesbare beskrivelser av den samme tingen.

Beskrivelse

HTML

For å følge unAPI-standarden kan for eksempel en OPAC-side som beskriver en bok, inneholde følgende formatering av ISBN-nummeret:

<abbr class="unapi-id" title="urn:isbn:123456789X">ISBN 1-234-56789-X</abbr>

(Dette fungerer på samme måte som et mikroformat, men er ikke anerkjent som dette.)

I tillegg må det i HEAD-seksjonen av OPAC-siden spesifiseres en URL som kan tjene som mål for unAPI-forespørsler:

<link rel="unapi-server" type="application/xml" title="unAPI" href="http://example.com/unapi/" />

unAPI-mål

unAPI-mål-URLen må støtte tre typer forespørsler.

En forespørsel uten parametere skal returnere et XML-dokument som sier noe om hvilke formater beskrivelsene av alle "tingene" tjenesten vet noe om er tilgjengelige i.

http://example.com/unapi/

En forespørsel med en id-parameter skal returnere et XML-dokument som sier noe om hvilke formater beskrivelsene av den tingen id-parameteren peker til er tilgjengelig i:

http://example.com/unapi/?id=urn:isbn:123456789X

En forespørsel med både en id- og en format-parameter skal returnere en beskrivelse av tingen id-attributtet peker til, i det spesifiserte formatet.

http://example.com/unapi/?id=urn:isbn:123456789X&format=marcxml

Lenker

Personlige verktøy