Norsk

Hva som kjører nå, og hva som endret seg underveis. Versjonene er lest fra PLAS Status, som er den eneste versjonsautoriteten; endringene er kildens egne ord ved siden av den målte forskjellen mellom spesifikasjonene.

Sist oppdatert

Versjoner

Versjoner per API
APIRolleI produksjonI spesifikasjonReferanse
Provider API Inngang v0.6.5 v0.6.6 Provider API v0.6.5
Search API Profil av Provider API 8 av 54 operasjoner v0.6.5 Search API v0.6.5
Content API Profil av Provider API 4 av 54 operasjoner v0.6.5 Content API v0.6.5
Vendor Consumer API Inngang v0.6.5 Vendor API v0.6.5

Slik leses tabellen

  • I produksjon er den versjonen providere implementerer og klienter kan regne med i dag. Det er også versjonen referansen på dette nettstedet er generert ut fra.
  • I spesifikasjon er den versjonen PLAS-teamet arbeider med. Den er ikke publisert, og felter kan endre seg til den er det.
  • Referanse peker på den genererte dokumentasjonen av produksjonsversjonen.

Endrer PLAS Status seg i Confluence, fornyes kopien i repoet som en bevisst handling, og tabellen følger med.

Ett versjonsnummer, fire API-er. De fire API-ene publiseres på samme nummer, og det er målt framfor antatt: Search og Content gikk fra 0.6.4 til 0.6.5 uten en eneste strukturell endring — bare versjonsnummeret er nytt — mens Vendor hoppet over 0.6.4 og gikk rett fra 0.6.3 til 0.6.5, der den ene nye operasjonen er nøyaktig den PLAS Status noterer under v0.6.5.

Eldre versjoner

Bare produksjonsversjonen har genererte sider. Eldre utgaver er fortsatt i drift hos providere, men har ingen referanse her ennå — identifikatorene deres står derfor uten lenke. En referanse-URL som først er publisert, fortsetter å virke, så eldre versjoner legges til når behovet er avklart; de fjernes ikke igjen.

Slik leses en versjon

  • Ifølge PLAS Status er kildens tekst. Der kilden selv skriver «(Added) Patron API», står det som merker foran linjen.
  • Endringer i spesifikasjonen står som én blokk per API. «Flyttet» betyr at en operasjon har byttet metode eller sti med samme operationId; har den fått ny operationId, står den som fjernet og lagt til — det er hva spesifikasjonen sier.
  • Null endringer er også et resultat. En blokk som sier at ingenting endret seg, sier at API-et fikk et nytt versjonsnummer og ellers sto stille.
  • Versjoner uten en spesifikasjon i kopien viser bare kildens tekst og sier det.

Filteret over listen viser ett API om gangen. Uten JavaScript står alle fire.

Endringer per versjon

v0.6.6 I spesifikasjon

Ifølge PLAS Status

Ingen changelog-tekst i PLAS Status for denne versjonen.

Ingen spesifikasjon i kopien for denne versjonen — bare teksten fra PLAS Status.

v0.6.5 I produksjon

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

Endringer i spesifikasjonen — Provider API (fra v0.6.4)

Operasjoner

2 lagt til

1 fjernet

  • GET /patron/authentication/identity-provider AuthenticatePatronByIdentityProvider

Endringer i spesifikasjonen — Search API (fra v0.6.4)

Ingen strukturelle endringer mellom de to spesifikasjonene.

Endringer i spesifikasjonen — Content API (fra v0.6.4)

Ingen strukturelle endringer mellom de to spesifikasjonene.

Endringer i spesifikasjonen — Vendor API (fra v0.6.3)

Operasjoner

1 lagt til

v0.6.4 I produksjon

Ifølge PLAS Status

  • added Content Added the Content Events API

Endringer i spesifikasjonen — Provider API (fra v0.6.3)

Operasjoner

3 lagt til

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

43 lagt til

  • 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 endret

  • ConfigurationResponseBody
    • felt content (ConfigurationContentWithApi) lagt til
  • LocationBranch
    • felt pickup (object) lagt til
  • LocationsResponseBody
    • felt mainBranch er nå valgfritt
  • PatronAddress
    • form: object → Address
    • felt city fjernet
    • felt country fjernet
    • felt postalCode fjernet
    • felt street fjernet

Endringer i spesifikasjonen — Search API

Første vendorerte utgave — ingen eldre å sammenligne med.

Endringer i spesifikasjonen — Content API

Første vendorerte utgave — ingen eldre å sammenligne med.

v0.6.3 I produksjon

Ifølge PLAS Status

Merknad 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.

Endringer i spesifikasjonen — Provider API

Første vendorerte utgave — ingen eldre å sammenligne med.

Endringer i spesifikasjonen — Vendor API

Første vendorerte utgave — ingen eldre å sammenligne med.

v0.6.2 I produksjon

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 spesifikasjon i kopien for denne versjonen — bare teksten fra PLAS Status.