Primo REST API Search (geschlossen)

Primo Search bietet die Möglichkeit, in den Primo PNX-Records nach Stichworten in den Indices title, creator, subject, usertag sowie in allen Indices ("überall") zu suchen. Für die Nutzung wird ein API Key benötigt, der nur für bibliotheksinterne Zwecke vergeben wird.

Resource URL:

GET /primo/v1/search 

Ex Libris Dokumentation:
https://developers.exlibrisgroup.com/primo/apis/docs/primoSearch/R0VUIC9wcmltby92MS9zZWFyY2g=

Beschreibung

Primo Search liefert standardmässig JSON zurück.

Es werden 10 Records auf einmal zurückgegeben. Um die nächsten 10 zu erhalten, kann "&offset=10" an die URL angehängt werden (bei Offset 10 kommt Record 11 als erstes zurück).

Datengrundlage im Primo-Search-Index ist das sogenannte PNX-Record. Infos dazu finden sich hier:
https://knowledge.exlibrisgroup.com/Primo/Product_Documentation/020Primo_VE/Primo_VE_(English)/120Other_Configurations/Mapping_to_the_Display%2C_Facets%2C_and_Search_Sections_in_the_Primo_VE_Record.

Allerdings scheinen nicht alle Indexfelder des PNX-Records dokumentiert zu sein, z.B. "lsr_56" fehlt, obwohl es in den Daten vorkommt (siehe Bsp. zu DDC unten).

Required arguments

• vid
  vid=41SLSP_UZB:UZB

• tab
  tab=default_tab

• scope
  scope=default_scope

• q
  Dieser Parameter enthält die eigentliche Suchabfrage. Syntax:
  field,precision,value

  Mögliche Werte für "fields":

  • any (for any field)
  • title
  • creator
  • sub (for subject)
  • usertag (for tag)

  
  Mögliche Werte für "precision":
  

  • exact
  • begins_with
  • contains

  
  Mögliche Werte für "value":
  The search terms, which can be a word, phrase, or exact phrase (group of words enclosed by quotes), and can include the following logical operators: AND, OR, and NOT.
  
  

  Beispiele:

    q=title,contains,home
    q=title,contains,pop music,AND;sub,contains,korean
  

Abfrage-Beispiele

Records mit Autor "Steinfels":

https://api-eu.hosted.exlibrisgroup.com/primo/v1/search?vid=41SLSP_UZB:UZB&tab=default_tab&scope=default_scope&q=creator,contains,steinfels&apikey=myapikey

Records mit Thema "Digital Humanities":

https://api-eu.hosted.exlibrisgroup.com/primo/v1/search?vid=41SLSP_UZB:UZB&tab=default_tab&scope=default_scope&q=sub,exact,%22digital%20humanities%22&apikey=myapikey

Es scheint bei diesem Bsp. keinen Unterschied zu machen, ob precision "exact" oder "contains" verwendet wird.

Records mit DDC (Dewey Decimal Classification) Notation für Digital Humanities oder Thema "Digital Humanities":

https://api-eu.hosted.exlibrisgroup.com/primo/v1/search?vid=41SLSP_UZB:UZB&tab=default_tab&scope=default_scope&q=sub,exact,%22digital%20humanities%22,OR;any,contains,001.30285&apikey=myapikey

DDC ist laut Ex Libris Dokumentation keines der Felder, das man spezifisch durchsuchen kann. Im PNX-Record scheint der Code im Feld "lds56" zu stehen.