SFM Basis API Implementation Guide

Versioning

The API version will be a part of the BASE_URI.

Example:

  • Endpoint: api.forskrivning.no/sfmbasis
  • Version: v1.0
  • protocol: https

BASE_URI for this FHIR API is: https://api.forskrivning.no/sfmbasis/v1.0/

Version of the API is not mapped to versions of functionality in SFM. SFM changes may be also be reflected in the content of resources in this API, without change in the API version. Major changes in SFM will be announced elswehere, according to change management in Norwegian e-respet. Minor changes will be analyzed for consequences and communicated to relevant system vendors and users.

The API versioning is not to be confused with version management in SFM organization configuration. This functionality is to provide step-wise introduction of new features for the systems using the SFM GUI.

System vendors implementing the SFM API Basis are responsible of version selection management.

DISCLAIMER FOR PRELIMINARY version: The version of this API Implementation guide and all the resources is subject to change until a notice on stability is issued in due advance on production setting. The SFM as well as the API implementation is under development and changes may come related to (including but not limited to):

  • Revision of single extensions or profiles
  • Change from sfm-specific to no-basis profilation
  • Obstacles in implementation the specified resources
  • Requests from Helseplattformen
  • Changes in Norwegian e-resept specifications