Dansk
English Norsk Dansk
English Norsk Dansk

Versioner og changelog

Vis som Markdown Sidens .md-fil Åbn i ChatGPT Stil spørgsmål om siden Åbn i Claude Stil spørgsmål om siden

Hvad der kører nu, hvad der ændrede sig undervejs, og hvor hver udgave hentes. Versionerne kommer fra PLAS-teamets egen statusside; ændringerne står som kildens egne ord ved siden af forskellen mellem specifikationerne.

Sidst opdateret

Versioner

Versioner pr. API
APIRolleI produktionI specifikationReference
Provider API Indgang v0.6.5 v0.6.6 Provider API v0.6.5
Search API Profil af Provider API 8 af 54 operationer v0.6.5 — Search API v0.6.5
Content API Profil af Provider API 4 af 54 operationer v0.6.5 — Content API v0.6.5
Vendor Consumer API Indgang v0.6.5 — Vendor API v0.6.5

Sådan læses tabellen

  • I produktion er den version providere implementerer og klienter kan regne med i dag. Det er også den version referencen på dette site er genereret ud af.
  • I specifikation er den version PLAS-teamet arbejder på. Den er ikke udgivet, og felter kan ændre sig indtil den er.
  • Reference peger på den genererede dokumentation af produktionsversionen.
  • Versionsnummeret henter selve OpenAPI-filen.

Ét versionsnummer, fire API’er. De fire API’er udgives på samme nummer. Search og Content gik fra 0.6.4 til 0.6.5 uden en eneste strukturel ændring — kun versionsnummeret er nyt — mens Vendor sprang 0.6.4 over og gik direkte fra 0.6.3 til 0.6.5, hvor dens ene nye operation er præcis den PLAS Status noterer under v0.6.5.

Ældre versioner

Kun produktionsversionen har genererede reference-sider. De ældre udgaver kan hentes som OpenAPI-filer under «Spec-filer» nederst på siden: de er stadig i drift hos providere, og skal en klient tale med et system på en ældre version, er det den specifikation systemet er bygget efter.

Sådan læses en version

  • Ifølge PLAS Status er kildens egen tekst. Skriver kilden »(Added)« foran en linje, står det som et mærke.
  • Ændringer i specifikationen står som én blok pr. API. »Flyttet« betyder at en operation har skiftet metode eller sti med samme operationId; har den fået nyt operationId, står den som fjernet og tilføjet — det er hvad specifikationen siger.
  • Nul ændringer er også et resultat. En blok der siger at intet ændrede sig, siger at API’et fik et nyt versionsnummer og ellers stod stille.
  • Versioner uden en specifikation at sammenligne med viser kun kildens tekst og siger det.

Filteret over listen viser ét API ad gangen.

Ændringer pr. version

v0.6.6 I specifikation

Ifølge PLAS Status

Ingen changelog-tekst i PLAS Status for denne version.

Ingen specifikation i kopien for denne version — kun PLAS Status’ tekst.

v0.6.5 I produktion

Ifølge PLAS Status

  • updated Patron API Replace GET /patron/authentication/identity-provider with POST /patron/authentication/identity-provider, and changed the return object
  • added Patron API Added GET /patron/authentication/authenticate-token
  • added Vendor API Added GET /callbacks/patron/auth

Ændringer i specifikationen — Provider API (fra v0.6.4)

Operationer

2 tilføjet

1 fjernet

  • GET /patron/authentication/identity-provider AuthenticatePatronByIdentityProvider
Skemaer

2 tilføjet

1 ændret

Ændringer i specifikationen — Search API (fra v0.6.4)

Ingen strukturelle ændringer mellem de to specifikationer.

Ændringer i specifikationen — Content API (fra v0.6.4)

Ingen strukturelle ændringer mellem de to specifikationer.

Ændringer i specifikationen — Vendor API (fra v0.6.3)

Operationer

1 tilføjet

v0.6.4 I produktion

Ifølge PLAS Status

  • added Content Added the Content Events API

Ændringer i specifikationen — Provider API (fra v0.6.3)

Operationer

3 tilføjet

  • GET /configuration/content GetContentConfiguration
  • GET /content/event GetContentEvents
  • GET /content/event/series/{seriesId} GetContentEventsInSeries
Skemaer

43 tilføjet

  • Address
  • AllDayScheduling
  • ConfigurationContentApi
  • ConfigurationContentResponseBody
  • ConfigurationContentWithApi
  • ContactInfo
  • Event
  • EventAdmission
  • EventAudience
  • EventBranch
  • EventCategory
  • EventLocation
  • EventLocationAtBranch
  • EventLocationExternal
  • EventOrganizer
  • EventPriceCategory
  • EventPricing
  • EventPricingPriceCategories
  • EventPricingSimple
  • EventScheduling
  • EventSeries
  • EventState
  • GetContentEventsInSeriesResponseBody
  • GetContentEventsResponseBody
  • ImageAlt
  • ImageCredit
  • ImageFocalPoint
  • ImageFocalPointHotspot
  • ImageOriginal
  • ImageTypeContent
  • OpenAdmission
  • Promoted
  • PromotedType
  • PromotedTypeEnum
  • PromotedTypeLiteral
  • QueryRelevantWorks
  • RegistrationAdmission
  • RelatedEvents
  • RelevantWorks
  • TicketAdmission
  • TicketState
  • TimeSpanScheduling
  • WorksRelevantWorks

4 ændret

  • ConfigurationResponseBody
    • felt content (ConfigurationContentWithApi) tilføjet
  • LocationBranch
    • felt pickup (object) tilføjet
  • LocationsResponseBody
    • felt mainBranch er nu valgfrit
  • PatronAddress
    • form: object → Address
    • felt city fjernet
    • felt country fjernet
    • felt postalCode fjernet
    • felt street fjernet

Ændringer i specifikationen — Search API

Første vendorede udgave — ingen ældre at sammenligne med.

Ændringer i specifikationen — Content API

Første vendorede udgave — ingen ældre at sammenligne med.

v0.6.3 I produktion

Ifølge PLAS Status

Note fra PLAS Status: Expected release to production: Week 19

  • Added mainBranch to /locations
  • Added that it is recommended to use UUIDs as patron IDs
  • Added suggestions on ways of controlling customers and vendors
  • Added a security recommendation for patron authentication
  • Added error code for "Consent has not been given for 'loan history'"
  • Bugfix in GET /holdings, change explode from true to false, for the two parameters publicationId and showTo
  • Added a general description of the response structure for endpoints that takes an array of ids
  • Bugfix ensuring all query parameters are in snake case
  • Added patron_id to /holdings
  • Added pickupBranches to /locations, and removed branches[]->pickup->allow
  • Added GET /patron/{patronId}/configuration containing reservation limits and pickupBranches so that pickup branches can differ between patrons.
  • Added pickupBranches to /holdings, so that titles and items can overwrite pickup branches settings from /patron/{patronId}/configuration and /locations.
  • Added "fulfillmentBy" to reservation and removed "isInterlibraryLoan"
  • Added "acquiredFrom" to loan and removed "isInterlibraryLoan"
  • Added "acquiredFrom" to checkout and removed "isInterlibraryLoan"
  • Added "acquiredFrom" to checkin and removed "isInterlibraryLoan"
  • Added "acquiredFrom" to fee and removed "isInterlibraryLoan"
  • Added "acquiredFrom" to loan history and removed "isInterlibraryLoan", for both get loan history and add to loan history.

Ændringer i specifikationen — Provider API

Første vendorede udgave — ingen ældre at sammenligne med.

Ændringer i specifikationen — Vendor API

Første vendorede udgave — ingen ældre at sammenligne med.

v0.6.2 I produktion

Ifølge PLAS Status

  • Bug fix in the description of AudienceTypeAgeGroupCode
  • Added 'verified' to PatronEmail and PatronPhoneNumber
  • Added 'fields' to ConfigurationPatron, including ConfigurationPatronFieldEmails, ConfigurationPatronFieldPhoneNumbers and ConfigurationPatronFieldPickupLocation
  • Added errors code for if maxNumberOfEmailAddresses or maxNumberOfPhoneNumbers is exceeded
  • Bug fix, change section to an array in PickupLocation, CheckOutOrInLocationWithoutNames and PickupLocationWithoutNames
  • Added default patron list id
  • Added minimum patron list id length
  • Replaced PatronListItemWork and PatronListItemPublication with PatronListItemWorkAndPublication

Ingen specifikation i kopien for denne version — kun PLAS Status’ tekst.

Spec-filer

Hver udgave ligger som den OpenAPI-fil den blev udgivet med — også de ældre, som stadig er i drift hos providere. Filerne er verificerede kopier af PLAS-teamets egne.

Vendorede OpenAPI-filer pr. API og version
APIVersionTilstandOpdateretStørrelseFil
Provider API v0.6.5 I produktion 9. dec. 2025 230 kB provider_v0_6_5.yaml
Provider API v0.6.4 Arkiv 9. dec. 2025 227 kB provider_v0_6_4.yaml
Provider API v0.6.3 Arkiv — 202 kB provider_v0_6_3-002.yaml
Search API v0.6.5 I produktion — 68 kB search_v0_6_5.yaml
Search API v0.6.4 Arkiv — 68 kB search_v0_6_4.yaml
Content API v0.6.5 I produktion — 30 kB content_v0_6_5.yaml
Content API v0.6.4 Arkiv — 30 kB content_v0_6_4.yaml
Vendor Consumer API v0.6.5 I produktion — 66 kB vendor_v0_6_5.yaml
Vendor Consumer API v0.6.3 Arkiv 13. maj 2025 64 kB vendor_v0_6_3.yaml