# Patron Loan History Provider API v0.6.3 · 3 operasjoner Kilde: https://plasapi.com/no/provider/v0.6.3/patron-loan-history/ Ingen beskrivelse i spesifikasjonen. ## Get patron loan history `GET` `/patron/{patronId}/loan-history` · `GetPatronLoanHistory` ### Eksempel på kall **cURL** ```bash curl -X GET "$PLAS_BASE_URL/patron/40218873/loan-history?version=0.6.3&before=2025-03-14T10%3A24%3A00%2B01%3A00&offset=0&size=10" \ -H 'Accept: application/json' \ -H "Authorization: Bearer $PLAS_TOKEN" ``` **JavaScript** ```javascript const response = await fetch(`${process.env.PLAS_BASE_URL}/patron/40218873/loan-history?version=0.6.3&before=2025-03-14T10%3A24%3A00%2B01%3A00&offset=0&size=10`, { method: "GET", headers: { "Accept": "application/json", "Authorization": `Bearer ${process.env.PLAS_TOKEN}`, }, }); const data = await response.json(); ``` **Python** ```python import os import requests response = requests.get( f"{os.environ['PLAS_BASE_URL']}/patron/40218873/loan-history", params={ "version": "0.6.3", "before": "2025-03-14T10:24:00+01:00", "offset": "0", "size": "10", }, headers={ "Accept": "application/json", "Authorization": f"Bearer {os.environ['PLAS_TOKEN']}", }, ) data = response.json() ``` Verten og tokenet er miljøvariabler: `PLAS_BASE_URL` providerens adresse · `PLAS_TOKEN` et access token. ### Parametere - `patronId` (i `path`, `string`, påkrevd) — Patron ID from authentication - `before` (i `query`, `string (date-time)`, påkrevd) — This tells the time period for when we fetch data. The period will be (-∞, before]. - `offset` (i `query`, `integer`, påkrevd) — This tells the offset. The offset should be 0 or above. - `size` (i `query`, `integer`, påkrevd) — This tells the size of the request. The size should be between 1 and 50. - `sorting_type` (i `query`, `string enum`, valgfri) — This can be used to choose the value (default: addedToHistoryTime) that the response is sorted on. When sorting, some entries might not have the chosen sorting type (or it may be null). When this happens, the entries should be sorted last when sorting order is `desc`, and then be sorted on addedToHistoryTime. - `sorting` (i `query`, `string enum`, valgfri) — This can be used to choose if response should be sorted descending (default) or ascending. Felles for operasjonene: `version`. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) ### Svar #### `200` Success `PatronLoanHistoryResponseBody` Eksempel (Generert fra skjemaet): ```json { "loanHistory": [ { "acquiredFrom": { "type": "local_circulation" }, "addedToHistoryTime": "2025-03-14T10:24:00+01:00", "checkinTime": "2025-03-14T10:24:00+01:00", "checkoutTime": "2025-03-14T10:24:00+01:00", "dueDate": "2025-04-11", "id": "94549", "itemId": "03011042557129", "loanId": "58210447", "manuallyAdded": false, "publicationId": "310552", "publicationMetadata": { "additionalIdentifiers": [ { "digits": "10", "type": "isbn", "value": "9788203363344" } ], "binding": { "type": "literal", "value": "Hardback" }, "contributors": [ { "agent": { "description": "Norwegian novelist, awarded the Nobel Prize in Literature in 1928.", "fullName": "Sigrid Undset", "id": "agent-4102", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "agent" } ], "active": { "type": "literal", "value": "1882-1949" }, "birthDate": { "type": "literal", "value": "1920" }, "deathDate": { "type": "literal", "value": "1920" }, "externals": { "identifiers": [ { "type": "norwegianAuthorityFile", "value": "4102" } ] }, "givenName": "Kari", "surname": "Nordmann", "type": "person" }, "roles": [ { "roleCode": "aut", "type": "marcRelator" } ] } ], "creators": [ { "agent": { "description": "Norwegian novelist, awarded the Nobel Prize in Literature in 1928.", "fullName": "Sigrid Undset", "id": "agent-4102", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "agent" } ], "active": { "type": "literal", "value": "1882-1949" }, "birthDate": { "type": "literal", "value": "1920" }, "deathDate": { "type": "literal", "value": "1920" }, "externals": { "identifiers": [ { "type": "norwegianAuthorityFile", "value": "4102" } ] }, "givenName": "Kari", "surname": "Nordmann", "type": "person" }, "roles": [ { "roleCode": "aut", "type": "marcRelator" } ] } ], "edition": { "type": "literal", "value": "2nd edition" }, "extent": [ { "type": "literal", "value": "312 pages" } ], "identifier": "310552", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "frontCover" } ], "language": [ { "code": "SplxlOBeZQQYbYS6WxSbIA", "name": "Kari Nordmann" } ], "mediaTypes": [ { "code": "book", "name": "Kari Nordmann" } ], "publicationDate": { "type": "literal", "value": "1920" }, "publishers": [ { "places": [ { "place": "Oslo" } ], "publisher": { "id": "94549", "name": "Kari Nordmann" } } ], "titles": [ { "language": { "code": "SplxlOBeZQQYbYS6WxSbIA", "name": "Kari Nordmann" }, "main": "Kristin Lavransdatter", "part": { "name": "Kari Nordmann", "number": "1" }, "remainder": "The Wreath", "type": "preferred" } ], "works": [ { "identifier": "882107", "relation": "contains" } ] } } ] } ``` #### `400` The list of errors. `Errors` Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) Eksempel (Generert fra skjemaet): ```json { "errors": [ { "code": 200103, "info": "200103: invalid/unsupported query parameter value" } ] } ``` #### `401` Bearer token invalid, missing, or expired. Ikke noe innhold i svaret. Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) #### `404` Resource not found. Ikke noe innhold i svaret. Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) ## Adds a loan to the patron's loan history `POST` `/patron/{patronId}/loan-history` · `AddLoanToPatronLoanHistory` ### Eksempel på kall **cURL** ```bash curl -X POST "$PLAS_BASE_URL/patron/40218873/loan-history?version=0.6.3" \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $PLAS_TOKEN" \ -d '{ "acquiredFrom": { "type": "local_circulation" }, "checkinTime": "2025-03-14T10:24:00+01:00", "checkoutTime": "2025-03-14T10:24:00+01:00", "dueDate": "2025-04-11", "itemId": "03011042557129", "loanId": "58210447", "manuallyAdded": false, "publicationId": "310552", "publicationMetadata": { "additionalIdentifiers": [ { "digits": "10", "type": "isbn", "value": "9788203363344" } ], "binding": { "type": "literal", "value": "Hardback" }, "contributors": [ { "agent": { "description": "Norwegian novelist, awarded the Nobel Prize in Literature in 1928.", "fullName": "Sigrid Undset", "id": "agent-4102", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "agent" } ], "active": { "type": "literal", "value": "1882-1949" }, "birthDate": { "type": "literal", "value": "1920" }, "deathDate": { "type": "literal", "value": "1920" }, "externals": { "identifiers": [ { "type": "norwegianAuthorityFile", "value": "4102" } ] }, "givenName": "Kari", "surname": "Nordmann", "type": "person" }, "roles": [ { "roleCode": "aut", "type": "marcRelator" } ] } ], "creators": [ { "agent": { "description": "Norwegian novelist, awarded the Nobel Prize in Literature in 1928.", "fullName": "Sigrid Undset", "id": "agent-4102", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "agent" } ], "active": { "type": "literal", "value": "1882-1949" }, "birthDate": { "type": "literal", "value": "1920" }, "deathDate": { "type": "literal", "value": "1920" }, "externals": { "identifiers": [ { "type": "norwegianAuthorityFile", "value": "4102" } ] }, "givenName": "Kari", "surname": "Nordmann", "type": "person" }, "roles": [ { "roleCode": "aut", "type": "marcRelator" } ] } ], "edition": { "type": "literal", "value": "2nd edition" }, "extent": [ { "type": "literal", "value": "312 pages" } ], "identifier": "310552", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "frontCover" } ], "language": [ { "code": "SplxlOBeZQQYbYS6WxSbIA", "name": "Kari Nordmann" } ], "mediaTypes": [ { "code": "book", "name": "Kari Nordmann" } ], "publicationDate": { "type": "literal", "value": "1920" }, "publishers": [ { "places": [ { "place": "Oslo" } ], "publisher": { "id": "94549", "name": "Kari Nordmann" } } ], "titles": [ { "language": { "code": "SplxlOBeZQQYbYS6WxSbIA", "name": "Kari Nordmann" }, "main": "Kristin Lavransdatter", "part": { "name": "Kari Nordmann", "number": "1" }, "remainder": "The Wreath", "type": "preferred" } ], "works": [ { "identifier": "882107", "relation": "contains" } ] } }' ``` **JavaScript** ```javascript const response = await fetch(`${process.env.PLAS_BASE_URL}/patron/40218873/loan-history?version=0.6.3`, { method: "POST", headers: { "Accept": "application/json", "Content-Type": "application/json", "Authorization": `Bearer ${process.env.PLAS_TOKEN}`, }, body: JSON.stringify({ "acquiredFrom": { "type": "local_circulation" }, "checkinTime": "2025-03-14T10:24:00+01:00", "checkoutTime": "2025-03-14T10:24:00+01:00", "dueDate": "2025-04-11", "itemId": "03011042557129", "loanId": "58210447", "manuallyAdded": false, "publicationId": "310552", "publicationMetadata": { "additionalIdentifiers": [ { "digits": "10", "type": "isbn", "value": "9788203363344" } ], "binding": { "type": "literal", "value": "Hardback" }, "contributors": [ { "agent": { "description": "Norwegian novelist, awarded the Nobel Prize in Literature in 1928.", "fullName": "Sigrid Undset", "id": "agent-4102", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "agent" } ], "active": { "type": "literal", "value": "1882-1949" }, "birthDate": { "type": "literal", "value": "1920" }, "deathDate": { "type": "literal", "value": "1920" }, "externals": { "identifiers": [ { "type": "norwegianAuthorityFile", "value": "4102" } ] }, "givenName": "Kari", "surname": "Nordmann", "type": "person" }, "roles": [ { "roleCode": "aut", "type": "marcRelator" } ] } ], "creators": [ { "agent": { "description": "Norwegian novelist, awarded the Nobel Prize in Literature in 1928.", "fullName": "Sigrid Undset", "id": "agent-4102", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "agent" } ], "active": { "type": "literal", "value": "1882-1949" }, "birthDate": { "type": "literal", "value": "1920" }, "deathDate": { "type": "literal", "value": "1920" }, "externals": { "identifiers": [ { "type": "norwegianAuthorityFile", "value": "4102" } ] }, "givenName": "Kari", "surname": "Nordmann", "type": "person" }, "roles": [ { "roleCode": "aut", "type": "marcRelator" } ] } ], "edition": { "type": "literal", "value": "2nd edition" }, "extent": [ { "type": "literal", "value": "312 pages" } ], "identifier": "310552", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "frontCover" } ], "language": [ { "code": "SplxlOBeZQQYbYS6WxSbIA", "name": "Kari Nordmann" } ], "mediaTypes": [ { "code": "book", "name": "Kari Nordmann" } ], "publicationDate": { "type": "literal", "value": "1920" }, "publishers": [ { "places": [ { "place": "Oslo" } ], "publisher": { "id": "94549", "name": "Kari Nordmann" } } ], "titles": [ { "language": { "code": "SplxlOBeZQQYbYS6WxSbIA", "name": "Kari Nordmann" }, "main": "Kristin Lavransdatter", "part": { "name": "Kari Nordmann", "number": "1" }, "remainder": "The Wreath", "type": "preferred" } ], "works": [ { "identifier": "882107", "relation": "contains" } ] } }), }); ``` **Python** ```python import os import requests response = requests.post( f"{os.environ['PLAS_BASE_URL']}/patron/40218873/loan-history", params={ "version": "0.6.3", }, headers={ "Accept": "application/json", "Content-Type": "application/json", "Authorization": f"Bearer {os.environ['PLAS_TOKEN']}", }, json={ "acquiredFrom": { "type": "local_circulation", }, "checkinTime": "2025-03-14T10:24:00+01:00", "checkoutTime": "2025-03-14T10:24:00+01:00", "dueDate": "2025-04-11", "itemId": "03011042557129", "loanId": "58210447", "manuallyAdded": False, "publicationId": "310552", "publicationMetadata": { "additionalIdentifiers": [ { "digits": "10", "type": "isbn", "value": "9788203363344", }, ], "binding": { "type": "literal", "value": "Hardback", }, "contributors": [ { "agent": { "description": "Norwegian novelist, awarded the Nobel Prize in Literature in 1928.", "fullName": "Sigrid Undset", "id": "agent-4102", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "agent", }, ], "active": { "type": "literal", "value": "1882-1949", }, "birthDate": { "type": "literal", "value": "1920", }, "deathDate": { "type": "literal", "value": "1920", }, "externals": { "identifiers": [ { "type": "norwegianAuthorityFile", "value": "4102", }, ], }, "givenName": "Kari", "surname": "Nordmann", "type": "person", }, "roles": [ { "roleCode": "aut", "type": "marcRelator", }, ], }, ], "creators": [ { "agent": { "description": "Norwegian novelist, awarded the Nobel Prize in Literature in 1928.", "fullName": "Sigrid Undset", "id": "agent-4102", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "agent", }, ], "active": { "type": "literal", "value": "1882-1949", }, "birthDate": { "type": "literal", "value": "1920", }, "deathDate": { "type": "literal", "value": "1920", }, "externals": { "identifiers": [ { "type": "norwegianAuthorityFile", "value": "4102", }, ], }, "givenName": "Kari", "surname": "Nordmann", "type": "person", }, "roles": [ { "roleCode": "aut", "type": "marcRelator", }, ], }, ], "edition": { "type": "literal", "value": "2nd edition", }, "extent": [ { "type": "literal", "value": "312 pages", }, ], "identifier": "310552", "images": [ { "height": 1200, "mime": "png", "url": "https://images.nordby.bibliotek.example/covers/310552.jpg", "width": 800, "type": "frontCover", }, ], "language": [ { "code": "SplxlOBeZQQYbYS6WxSbIA", "name": "Kari Nordmann", }, ], "mediaTypes": [ { "code": "book", "name": "Kari Nordmann", }, ], "publicationDate": { "type": "literal", "value": "1920", }, "publishers": [ { "places": [ { "place": "Oslo", }, ], "publisher": { "id": "94549", "name": "Kari Nordmann", }, }, ], "titles": [ { "language": { "code": "SplxlOBeZQQYbYS6WxSbIA", "name": "Kari Nordmann", }, "main": "Kristin Lavransdatter", "part": { "name": "Kari Nordmann", "number": "1", }, "remainder": "The Wreath", "type": "preferred", }, ], "works": [ { "identifier": "882107", "relation": "contains", }, ], }, }, ) response.raise_for_status() ``` Verten og tokenet er miljøvariabler: `PLAS_BASE_URL` providerens adresse · `PLAS_TOKEN` et access token. ### Parametere - `patronId` (i `path`, `string`, påkrevd) — Patron ID from authentication Felles for operasjonene: `version`. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) ### Request body `application/json` · påkrevd [`AddLoanToPatronLoanHistoryRequestBody`](https://plasapi.com/no/provider/v0.6.3/schemas/#AddLoanToPatronLoanHistoryRequestBody) ### Svar #### `204` Success Ikke noe innhold i svaret. #### `400` The list of errors. `Errors` Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) Eksempel (Generert fra skjemaet): ```json { "errors": [ { "code": 200103, "info": "200103: invalid/unsupported query parameter value" } ] } ``` #### `401` Bearer token invalid, missing, or expired. Ikke noe innhold i svaret. Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) #### `404` Resource not found. Ikke noe innhold i svaret. Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) ## Delete loan from patron loan history `DELETE` `/patron/{patronId}/loan-history/{loanHistoryId}` · `DeleteLoanFromPatronLoanHistory` ### Eksempel på kall **cURL** ```bash curl -X DELETE "$PLAS_BASE_URL/patron/40218873/loan-history/71150392?version=0.6.3" \ -H 'Accept: application/json' \ -H "Authorization: Bearer $PLAS_TOKEN" ``` **JavaScript** ```javascript const response = await fetch(`${process.env.PLAS_BASE_URL}/patron/40218873/loan-history/71150392?version=0.6.3`, { method: "DELETE", headers: { "Accept": "application/json", "Authorization": `Bearer ${process.env.PLAS_TOKEN}`, }, }); ``` **Python** ```python import os import requests response = requests.delete( f"{os.environ['PLAS_BASE_URL']}/patron/40218873/loan-history/71150392", params={ "version": "0.6.3", }, headers={ "Accept": "application/json", "Authorization": f"Bearer {os.environ['PLAS_TOKEN']}", }, ) response.raise_for_status() ``` Verten og tokenet er miljøvariabler: `PLAS_BASE_URL` providerens adresse · `PLAS_TOKEN` et access token. ### Parametere - `patronId` (i `path`, `string`, påkrevd) — Patron ID from authentication - `loanHistoryId` (i `path`, `string`, påkrevd) — Loan history ID Felles for operasjonene: `version`. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) ### Svar #### `204` Success Ikke noe innhold i svaret. #### `400` The list of errors. `Errors` Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) Eksempel (Generert fra skjemaet): ```json { "errors": [ { "code": 200103, "info": "200103: invalid/unsupported query parameter value" } ] } ``` #### `401` Bearer token invalid, missing, or expired. Ikke noe innhold i svaret. Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/) #### `404` Resource not found. Ikke noe innhold i svaret. Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.3/)