Skip to main content

Config for fhir

Jobs that use the fhir adaptor may require authentication. A "credential" for the fhir adaptor will follow the schema below. When using the CLI, you can set up your own state.configuration by using the sample below.

Sample Configuration​

Paste this into the configuration key of your state.json file and modify the values to run jobs locally.

{
  "baseUrl": "https://hapi.fhir.org/baseR4",
  "apiPath": "baseR4",
  "authType": "Basic",
  "token": "@super!scretetoken"
}

Full Schema​

The full configuration schema describes each attribute of the credential and notes those that are required.

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
      "baseUrl": {
          "title": "Base Url",
          "type": "string",
          "description": "The baseUrl",
          "examples": [
              "https://hapi.fhir.org/baseR4"
          ]
      },
      "apiPath": {
          "title": "API Path",
          "anyOf": [
              {
                  "type": "string"
              },
              {
                  "type": "null"
              }
          ],
          "placeholder": "R4",
          "description": "FHIR api path",
          "minLength": 1,
          "examples": [
              "baseR4",
              "R3",
              "R4"
          ]
      },
      "authType": {
          "title": "Auth Type",
          "type": "string",
          "description": "The type of authentication used to authenticate into the destination system",
          "examples": [
              "Basic"
          ]
      },
      "token": {
          "title": "Token",
          "type": "string",
          "description": "The token  used to authenticate into the destination system",
          "examples": [
              "@super!scretetoken"
          ]
      }
  },
  "required": [
      "resource",
      "authType",
      "token"
  ]
}