Skjemaer
Hvert navngitt skjema i spesifikasjonen, ett nivå dypt. Et felt som peker på et annet skjema, lenker til det i stedet for å bli foldet ut — spesifikasjonen refererer seg selv i sykluser, så en utfolding ville ikke terminere.
152 skjemaer · Generert fra vendor_v0_6_5.yaml Hvert felt står som navn, deretter type, deretter beskrivelse. En type som navngir et annet skjema, lenker til det.AdditionalIdentifier
one of AdditionalIdentifierTypeISBN | AdditionalIdentifierTypeISSN | AdditionalIdentifierTypeEAN | AdditionalIdentifierTypeBibsentBibbiAdditionalIdentifierTypeBibsentBibbi
- typepåkrevd
- string enumbibsentBibbi
- valuepåkrevd
- string
AdditionalIdentifierTypeEAN
- digitspåkrevd
- string enum13
- typepåkrevd
- string enumean
- valuepåkrevd
- string
AdditionalIdentifierTypeISBN
- digitspåkrevd
- string enum10 · 13
- typepåkrevd
- string enumisbn
- valuepåkrevd
- string
AdditionalIdentifierTypeISSN
- typepåkrevd
- string enumissn
- valuepåkrevd
- string
Agent
one of AgentTypePerson | AgentTypeCollectiveAgentPersonActiveLiteral
Date or date range the person was active. This is usually only recorded for historical persons where the birth and death dates are uncertain or unknown. A literal value, meaning there are no expected structure or format.
- typepåkrevd
- string enumliteral
- valuepåkrevd
- string
AgentRole
one of AgentRoleMarcRelatorTelling the role of an agent, e.g. author, illustrator, editor.
AgentRoleMarcRelator
- roleCodepåkrevd
- stringA contribution role code from the MARC Code List for Relators.
- typepåkrevd
- string enummarcRelatorIdentifies the role code as being part of [MARC Code List for Relators](https://www.loc.gov/marc/relators/relaterm.html).
AgentTypeCollective
all of BaseAgent + objectAgentTypePerson
all of BaseAgent + objectAmount
integerThe amount is in minor unit (see ISO 4217).
BaseAgent
- description
- stringThis is a description of the agent.
- fullNamepåkrevd
- stringThis is the full name of the agent.
- id
- stringThis isn't required, but if it's set: - The agent is searchable through the GET /agent endpoint. - Or you can search using the filter `plas.agent` to search on this agent.
- images
- array of ImageAgentImages of the agent.
BaseEventItem
- eventIdpåkrevd
- stringA unique identifier for the event.
- typepåkrevd
- stringThe type of event.
BasicTitle
- language
- LanguageThe language of the titles in the object.
- mainpåkrevd
- stringThis is the main title.
- part
- objectThis contains the information to distinguish the work.
- remainder
- stringThis is the remainder of the title.
Binding
one of BindingTypeLiteralBindingTypeLiteral
A literal binding, meaning there are no expected structure or format.
- typepåkrevd
- string enumliteral
- valuepåkrevd
- stringA displayable (human readable) representation of the binding.
CheckinField
- acquiredFrom
- PatronLoanAcquiredFrom
- dueDate
- string (date)This is the due date of the checkin item, meaning the date where item should (at the latest) be returned.
- itemIdpåkrevd
- stringThis is the item ID of the checked in item.
- loanIdpåkrevd
- LoanId
- patronId
- stringThis is the patron ID of the patron that made the checkin.
- publicationId
- stringThis is the publication ID of the checkin item.
- publicationMetadata
- PublicationFallback
- sortingCode
- stringThis is the sorting code, and can be used to sort checked in items, on e.g. a self service machine by reserved and not-reserved items.
- transactionDateTimepåkrevd
- string (date-time)This is the registered time and date of the checkin.
CheckinFieldWithRequiredPatronId
all of CheckinField + objectCheckinResponseBody
- checkinpåkrevd
- CheckinField
- completed
- booleanThis tells if the checkin was completed or not. It is only true if the checkin was completed, else it is false.
- message
- CheckOutOrInMessage
- requestIdpåkrevd
- stringThis is a unique identifier for the checkout request. This will change for each request.
- statuspåkrevd
- string enumcompleted · failedThis tells the status of the checkin. The status are: - `completed` means that the checkin went well and was completed. - `failed` means that the checkin failed, and the item was not checked in.
CheckinWithRequiredPatronIdResponseBody
all of CheckinResponseBody + objectCheckoutAcknowledgementType
- typepåkrevd
- stringThis is the type of what is to be acknowledged.
CheckoutAcknowledgementTypeFee
all of CheckoutAcknowledgementType + objectCheckoutAcknowledgementTypePreviouslyCheckedOut
all of CheckoutAcknowledgementType + objectCheckoutField
- acquiredFrom
- PatronLoanAcquiredFrom
- dueDatepåkrevd
- string (date)This is the due date of the checked out item.
- itemIdpåkrevd
- stringThis is the item ID of the checkout item.
- loanIdpåkrevd
- LoanId
- patronIdpåkrevd
- stringThis is the patron ID of the patron that made the checkout.
- publicationId
- stringThis is the publication ID of the checkout item.
- publicationMetadata
- PublicationFallback
- renew
- LoanRenewInfo
- transactionDateTimepåkrevd
- string (date-time)This is the registered time and date of the checkout.
CheckOutOrInLocationWithoutNames
The object tells the location where a checkout or checkin was made. The `sections` is for specifying the location more precisely.
- branchIdpåkrevd
- stringThe branch ID where the checkout or checkin was made.
- sections
- array of LocationSectionElementWithIdNameAndTypeThis is specifying the location more precisely.
CheckOutOrInMessage
Both type and text are optional, but at least one of them must be set.
- text
- stringMessage to the patron.
- type
- stringThis can be used instead of the text field to identify the message type. This can be used by a vendor to handle the message or control the content of the message.
CheckoutResponseBody
- acknowledgement
- objectIf this is set, the checkout needs to be acknowledged to be completed.
- checkoutpåkrevd
- CheckoutField
- message
- CheckOutOrInMessage
- requestIdpåkrevd
- stringThis is an unique identifier for the checkout request. This will change for each request.
- statuspåkrevd
- string enumcompleted · failedThis tells the status of the checkout. The status are: - `completed` means that the checkout went well and was completed. - `failed` means that the checkout failed, and the item was not checked out.
Contributor
- agentpåkrevd
- Agent
- roles
- array of AgentRoleList of roles (e.g. author, illustrator, editor) that the agent played in the creation of this entity.
Date
one of DateTypeLiteral | DateTypeRFC3339 | DateTypeYear | DateTypeYearRange | DateTypeCenturyDateTypeCentury
The *century* date can be used if we only know which century an event happened.
- beforeTheCommonEra
- booleanThe default value is *false*, meaning common era, otherwise before the common era.
- centurypåkrevd
- integerThe century e.g. 19 century CE (meaning 1801 CE to 1900 CE), 3 century BCE (meaning 300 BCE to 201 BCE)
- typepåkrevd
- string enumcentury
DateTypeLiteral
A literal date, meaning there are no expected structure or format.
- typepåkrevd
- string enumliteral
- valuepåkrevd
- string
DateTypeRFC3339
The *rfc3339* date can be used if we now the date.
- datepåkrevd
- string (date)RFC3339 _full-date_ format (YYYY-MM-DD).
- typepåkrevd
- string enumrfc3339
DateTypeYear
The *year* date can be used if we only know which year an event happened.
- typepåkrevd
- string enumyear
- yearpåkrevd
- integerEg. 1924
DateTypeYearRange
The *yearRange* date can be used if we only know approx when an event happened. This can also be used give an open ended year range. *from* and *to* isn't required, but a least one of them should be set.
- from
- integerEg. 1924
- to
- integerEg. 1979
- typepåkrevd
- string enumyearRange
Edition
one of EditionTypeLiteral | EditionTypeNumberingEditionTypeLiteral
A literal edition, meaning there are no expected structure or format.
- typepåkrevd
- string enumliteral
- valuepåkrevd
- stringA displayable (human readable) representation of the edition.
EditionTypeNumbering
- display
- stringA displayable (human readable) representation of the edition.
- numberpåkrevd
- integerThe edition number.
- printing
- integerThe printing number of the edition.
- typepåkrevd
- string enumnumbering
Error
ErrorCode
integer enumA number representing the type of error. List of error codes: - \<error code\>: \<error description\> - 500: System error - 600: Unsupported Open Library API version</br>
500 · 600ErrorInfo
stringStarts with the text matching the error code field (defined above), and a describing text could be added.
Errors
- errorspåkrevd
- array of ErrorThe first error should always be the most relevant.
EventConsentChanged
all of BaseEventItem + objectEventFeeDueDateIsApproaching
all of BaseEventItem + objectEventItemAddedToLoanHistory
all of BaseEventItem + objectEventItemCheckin
all of BaseEventItem + objectEventItemCheckout
all of BaseEventItem + objectEventItemPatronListCreated
all of BaseEventItem + objectEventItemPatronListDeleted
all of BaseEventItem + objectEventItemPatronListItemAddedToList
all of BaseEventItem + objectEventItemPatronListItemMovedOnList
all of BaseEventItem + objectEventItemPatronListItemRemovedFromList
all of BaseEventItem + objectEventItemPatronListUpdated
all of BaseEventItem + objectEventItemRemovedFromLoanHistory
all of BaseEventItem + objectEventLoanDueDateIsApproaching
all of BaseEventItem + objectEventPatronDeleted
all of BaseEventItem + objectEventReadyReservationExpiresSoon
all of BaseEventItem + objectEventReceiverRequest
one of EventConsentChanged | EventPatronDeleted | EventReservationReadyForPickup | EventReadyReservationExpiresSoon | EventReservationExpiresSoon | EventReservationReminder | EventLoanDueDateIsApproaching | EventFeeDueDateIsApproaching | EventItemCheckout | EventItemCheckinEventReservationExpiresSoon
all of BaseEventItem + objectEventReservationReadyForPickup
all of BaseEventItem + objectEventReservationReminder
all of BaseEventItem + objectExtent
one of ExtentTypeLiteral | ExtentTypePages | ExtentTypePlaytime | ExtentTypeUnitsExtentTypeLiteral
A literal extent, meaning there are no expected structure or format.
- typepåkrevd
- string enumliteral
- valuepåkrevd
- stringA displayable (human readable) representation of the extent.
ExtentTypePages
- pagespåkrevd
- integerNumber of physical pages.
- typepåkrevd
- string enumpages
ExtentTypePlaytime
- playtimepåkrevd
- integerThe total playtime in seconds.
- typepåkrevd
- string enumplaytime
ExtentTypeUnits
- typepåkrevd
- string enumunits
- unitTypepåkrevd
- string enumvolume · dvd · cd · bluRay · cassette · lp
- unitspåkrevd
- integerNumber of physical units (volumes, dvd, cd, ...)
FeeAmount
integerThe amount is in minor unit (see ISO 4217).
FeeCreatedTime
string (date-time)The date and time the fee was created.
FeeCurrency
stringISO 4217
FeeDueDate
string (date)The due date of the fee.
FeeId
stringThis is the fee ID.
FeeItem
Item information related to a fee.
- acquiredFrom
- PatronLoanAcquiredFrom
- itemIdpåkrevd
- stringThe item identifier of the item that the fee is about.
- publicationMetadatapåkrevd
- PublicationFallback
FeePayableState
string enumThis state tells if the fee can be paid and finalized through this API. - *payable*: The fee is payable, and can be finalized through this API. - *not_payable*: The fee cannot be finalized through this API.
payable · not_payableFeeRemainingAmount
AmountThe remaining amount is the amount that is still payable. If this is not equal to amount, part of the fee has been paid. The amount is in minor unit (see ISO 4217).
FeeType
string enumDefines the type of fee being applied. All fees indicate that the patron should pay, never the other way around. The possible values are: - *fee*: Indicates a regular fee, typically for a late checked-in loan. - *compensation*: Indicates a compensation fee, typically applied due to a damaged or lost item. - *send_to_debt_collector*: Indicates that the fee has been sent to a debt collector because it was not paid in time.
fee · compensation · send_to_debt_collectorGetVersionResponseBody
- versionpåkrevd
- VersionThis is recommended (by the vendor) version of the Open Library API, that is supported by the vendor.
ImageAgent
one of ImageTypeAgentImagePublication
one of ImageTypeFrontCover | ImageTypeBackCoverImageTypeAgent
all of ImageUrl + objectImageTypeBackCover
all of ImageUrl + objectImageTypeFrontCover
all of ImageUrl + objectImageUrl
- height
- integerThe image height in px.
- mime
- string enumpng · jpeg
- urlpåkrevd
- string
- width
- integerThe image width in px.
Language
- codepåkrevd
- stringA id that (if set) can be used with the filter `plas.language` to search on this genre. Codes can be found at <https://www.loc.gov/marc/languages/>
- name
- stringA displayable (human readable) value of the language.
LoanCreatedTime
string (date-time)The date and time the loan was made.
LoanDueDate
string (date)The latest date on which the loan must be returned.
LoanId
stringThis is the loan ID.
LoanItemId
stringThis is the item identifier of the checkout item.
LoanPublicationId
stringThis is the publication ID of the loan. If this is empty, the publication is unknown.
LoanRenewableState
string enumThis tells the renewable state of the loan.
renewable · not_renewable · renewable_later · unknownLoanRenewInfo
This contain information about renewal of the loan.
- count
- integerThe number of times this loan can still be renewed. If the field is missing, this information is unknown.
- lastDate
- string (date)The date when the loan was last renewed. If the field is missing, this information is unknown.
- statepåkrevd
- LoanRenewableState
LocationSectionElementType
stringThis should be the section type of the section (element) ID.
LocationSectionElementWithId
- idpåkrevd
- stringThis is the section (element) ID
LocationSectionElementWithIdAndName
all of LocationSectionElementWithId + objectLocationSectionElementWithIdNameAndType
all of LocationSectionElementWithIdAndName + objectMediaType
- code
- MediaTypeType
- namepåkrevd
- stringA displayable (human readable) representation of the media type.
MediaTypeEnum
string enum book · eBook · audiobookMediaTypeLiteral
stringMediaTypeType
any of MediaTypeEnum | MediaTypeLiteralA code that (if set) can be used with the filter `plas.mediaTypes` to search on this media type.
PatronConsent
- availablepåkrevd
- array of objectThe array must only contain one consent of each type.
- evaluatedpåkrevd
- PatronEvaluatedConsents
PatronConsentType
string enum loan_historyPatronEvaluatedConsent
- givenpåkrevd
- boolean
- typepåkrevd
- PatronConsentType
- versionpåkrevd
- stringThe version of the consent that the patron has made a choice for or against.
PatronEvaluatedConsents
array of PatronEvaluatedConsentThe array must only contain one consent of each type.
PatronFee
- amountpåkrevd
- FeeAmount
- createdTimepåkrevd
- FeeCreatedTime
- currencypåkrevd
- FeeCurrency
- dueDate
- FeeDueDate
- idpåkrevd
- FeeId
- items
- array of FeeItemThe items this fee covers, if they are known.
- payableStatepåkrevd
- FeePayableState
- remainingAmount
- FeeRemainingAmount
- typepåkrevd
- FeeType
PatronList
- idpåkrevd
- stringThe ID of the list.
- namepåkrevd
- stringThe name of the list.
PatronListBaseItem
- idpåkrevd
- stringThe unique ID of the item in the list.
PatronListItem
one of PatronListItemWorkAndPublicationPatronListItemWorkAndPublication
all of PatronListBaseItem + objectPatronLoan
- acquiredFrom
- PatronLoanAcquiredFrom
- createdTimepåkrevd
- LoanCreatedTime
- dueDatepåkrevd
- LoanDueDate
- idpåkrevd
- LoanId
- itemIdpåkrevd
- LoanItemId
- location
- CheckOutOrInLocationWithoutNames
- publicationIdpåkrevd
- LoanPublicationId
- publicationMetadata
- PublicationFallback
- renewpåkrevd
- LoanRenewInfo
PatronLoanAcquiredFrom
one of PatronLoanAcquiredFromTypeLocalCirculation | PatronLoanAcquiredFromTypeInterlibraryLoan | PatronLoanAcquiredFromTypeUnknownThis tells from where (the material for) this loan was acquired. If this field are missing, the default value **local_circulation** should be assumed. * **local_circulation**: Meaning that this loan was acquired from the customers own inventory. * **interlibrary_loan**: Meaning that this loan was acquired as a interlibrary loan. * **unknown**: Meaning that this information is unknown.
PatronLoanAcquiredFromTypeInterlibraryLoan
- typepåkrevd
- string enuminterlibrary_loan
PatronLoanAcquiredFromTypeLocalCirculation
- typepåkrevd
- string enumlocal_circulation
PatronLoanAcquiredFromTypeUnknown
- typepåkrevd
- string enumunknown
PatronLoanHistory
- acquiredFrom
- PatronLoanAcquiredFrom
- addedToHistoryTimepåkrevd
- string (date-time)The date and time when the loan was added to the patron loan history.
- checkinTime
- string (date-time)The date and time the loan was checkin.
- checkoutTime
- LoanCreatedTime
- dueDate
- string (date)The due date of the loan at the time of checkin.
- idpåkrevd
- stringThis is the loan history ID (not the loan ID).
- itemId
- LoanItemId
- loanId
- LoanId
- manuallyAddedpåkrevd
- booleanWas the loan added manually by the patron.
- publicationIdpåkrevd
- LoanPublicationId
- publicationMetadata
- PublicationFallback
PatronReservation
- createdTimepåkrevd
- ReservationCreatedTime
- expirationDate
- ReservationExpirationDate
- fulfillmentBy
- PatronReservationFulfillmentBy
- idpåkrevd
- ReservationId
- itemId
- ReservationItemId
- pickuppåkrevd
- object
- publicationIdpåkrevd
- ReservationPublicationId
- publicationMetadata
- PublicationFallback
- queueNumber
- ReservationQueueNumber
- statepåkrevd
- ReservationState
PatronReservationFulfillmentBy
one of PatronReservationFulfillmentByTypeLocalCirculation | PatronReservationFulfillmentByTypeInterlibraryLoan | PatronReservationFulfillmentByTypePurchase | PatronReservationFulfillmentByTypeUnknownThis tells from where the material that are expected to fulfill this reservation will be acquired from. If this field are missing, the default value **local_circulation** should be assumed. * **local_circulation**: (default) Meaning that this reservation will be fulfilling from the customers own inventory. * **interlibrary_loan**: Meaning that this reservation will be fulfilled as a interlibrary loan. * **purchase**: Meaning that reservation can not be fulfilled right away, but a request to purchase the material has been submitted. * **unknown**: Meaning that this information is unknown.
PatronReservationFulfillmentByTypeInterlibraryLoan
- typepåkrevd
- string enuminterlibrary_loan
PatronReservationFulfillmentByTypeLocalCirculation
- typepåkrevd
- string enumlocal_circulation
PatronReservationFulfillmentByTypePurchase
- typepåkrevd
- string enumpurchase
PatronReservationFulfillmentByTypeUnknown
- typepåkrevd
- string enumunknown
PickupLocation
The object tells a location where a reservation item can be picked up. The `sections` is for specifying the location more precisely. The branch name and section names are included in the response to make it easier to display the location. They are the same values as from the /locations endpoint.
- branchIdpåkrevd
- stringThe branch ID where a reservation should be picked up.
- branchNamepåkrevd
- stringThis is the name of the branch.
- sections
- array of LocationSectionElementWithIdNameAndTypeThis are specifying the location more precisely.
Publication
- additionalIdentifiers
- PublicationAdditionalIdentifiers
- binding
- Binding
- contributors
- PublicationContributors
- creators
- PublicationCreators
- edition
- Edition
- extent
- PublicationExtent
- identifierpåkrevd
- PublicationIdentifier
- images
- PublicationImages
- language
- PublicationLanguage
- mediaTypes
- PublicationMediaTypes
- publicationDate
- DateDate of publication.
- publishers
- array of PublisherAndPlacesList of publishers and associated place(s) of publication.
- titlespåkrevd
- PublicationTitles
- workspåkrevd
- array of PublicationWork
PublicationAdditionalIdentifiers
array of AdditionalIdentifierOther identifiers, like: ISBN, ISSN, ...
PublicationContributors
array of ContributorThe contributor(s) to the publication.
PublicationCreators
array of ContributorThe creator(s) of the publication.
PublicationExtent
array of ExtentTogether all the Extents in the array describes the total extent of the publication.
PublicationFallback
PublicationThis metadata is only intended as fallback data, for when the provider is not able to serve the metadata through the GET /publication endpoint. This can for some provider be the case when working with e.g. interlibrary loans.
PublicationIdentifier
stringPublication identifier. This is searchable through the GET /publication endpoint.
PublicationImages
array of ImagePublicationImages to use with the publication.
PublicationLanguage
array of LanguageThis is the language(s) of the this publication. If the publication uses multi languages this will also contain them.
PublicationMediaTypes
array of MediaTypePublicationTitles
array of TitleTitle of the publication.
PublicationWork
- identifierpåkrevd
- PublicationWorkIdentifier
- relation
- PublicationWorkRelation
PublicationWorkIdentifier
stringWork identifier of this publication. This is searchable through the GET /work endpoint.
PublicationWorkRelation
string enumDescribes the publications relation to a work. - contains: The publication contains this work, meaning the work is part of the publication. - embodies: The publication embodies this work, meaning the publication is the entire work.
contains · embodiesPublisher
- id
- stringThe unique identifier of the publisher. It can be used to search for the other entries by the publisher
- namepåkrevd
- stringThe publisher's name.
PublisherAndPlaces
- places
- array of PublisherPlacePlace of publication. Usually one place, but can be multiple.
- publisherpåkrevd
- Publisher
PublisherPlace
- placepåkrevd
- string
ReservationCreatedTime
string (date-time)The date and time the reservation was created.
ReservationExpirationDate
string (date)The date when the reservation expires. If this is missing, the value is unknown.
ReservationId
stringThis is the reservation ID.
ReservationItemId
stringThis is the item identifier that actually fulfills the reservation. This can often only be set when the reservation is ready for pickup. If the reservation is on item level, it can be set earlier.
ReservationPickupExpirationDate
string (date)The date for the last chance to pick up the reservation. If this is missing, the value is unknown.
ReservationPickupNote
stringThis is the note that is used to tell the patron where to get the reservation. E.g. - a shelf number, e.g. "Shelf 9". - an instruction, e.g. "Front desk" - an identifier, e.g. "10/114"
ReservationPublicationId
stringThis is the publication ID of the reservation. If this is empty, the publication is unknown.
ReservationQueueNumber
integerThe queue number tells what number in the queue the patron is. If this is missing, it represents that the queue number is unknown.
ReservationState
string enumThis represents where in the acquiring process this reservation is.
ready_for_pickup · in_queue · postponedTitle
one of TitleTypePreferred | TitleTypeVariant | TitleTypeParallel | TitleTypeOriginalTitleTypeOriginal
all of BasicTitle + objectTitleTypeParallel
all of BasicTitle + objectTitleTypePreferred
all of BasicTitle + objectTitleTypeVariant
all of BasicTitle + objectVersion
stringOpen Library API version.