PTS API Release Notes

All notable changes to the PTS API will be documented in this file.

Subscribe to notifications on #ext-utv-pts on Slack to be notified when we announce new releases.

You'll also notice we often use icons to visualize our changes and their effect, but we've limited ourselves to the following;

PTS API v0.5

These changes only affect POST /v0.5/access-restrictions/patient-safety/associate-parent, and you can still set $.cause for v0.3 and v0.4.

🍃 The $.cause field is no longer required
- This value is automatically set to Derived if a child restriction was created from its parent. Behaviour has not changed, and as such $.delayDeliveryUntil is still calculated based on the associated parent's $.delayDays and the specified $.delayFromTime. There are are also scenarios where this value isn't calculated, e.g. if the confidentiality code of the parent is N.

These changes affect all routes.

💥 The route for patient safety has changed from /access-restrictions/patient-safety to /v0.5/access-restrictions/patient-safety, and as such we no longer require the api-version header. The older versions, e.g. v0.3 and v0.4 still live on the old route and requires the api-version header to switch between the two.

These changes only affect POST /v0.5/access-restrictions/patient-safety

🍃 Introduced stricter validation when creating restrictions for both Rekvisisjon and Svarrapport to ensure that only well-formed restrictions are created.
- $.cause must be one of Manual or Automated
- $.delayDays can only be used for Rekvisisjon
- $.delayDeliveryUntil can only be used for Svarrapport
💥Changed type of $.createdBy from HealthIdIdentifiersDtoV04 to AuditablePartyDtoV05 since neither OffId nor HprNumber are available through client credentials tokens, and thus haven't been persisted. Instead the new auditable party type consits of clientId, orgNrParent, orgNrChild and orgNrSupplier as extracted from the Helse ID token used to create or update the resource.
💥 Replaced $.createdTime with $.createdDateTime

TL;DR: This version removes support for Bearer tokens and adds support for DPoP tokens

🍃 Results for POST /access-restrictions/patient-safety/_search is now ordered descending by created date