• In progress
  • POST /ServiceRequest

    Introduction

    This API will submit a new service request to the CIE Hub.

    Authorization

    The authorization will contain an API key and also will use an OAuth2 access token. An API key will be provided to each client that intends to consume this API. A development key and also a separate production key will be provided. If this key is not included then an authorization error will be returned.

    The process for getting an OAuth2 token can be found here Authorization

    Scope Needed For This API

    CIE Michigan Hub - cie.hub/fhir

     

    Rest URL

    The following are the URLs for this API. Please note that base url for the region you are looking for can be found here Community Information Exchange Hub Region URL

    Environment

    URL

    Environment

    URL

    Development

    POST https://fhir-dev.{cie-region}.org/ServiceRequest

    Headers

    The following will be headers that will need to be supplied

    Header

    Description

    Header

    Description

    x-api-key

    This will be a key that will provided by a community information exchange administrator.

    ContentType

    application/json

    Authorization

    This will be the access token that was retrieved using your client id and secret

    Request

    Note that the person ID passed as a parameter in the URL as documented in the REST URL section.

     

    Response

    The following will be the response values from the calling of the API. The error responses will conform ]to the following specification. RFC 7807: Problem Details for HTTP APIs . Please note that all responses will also include a instance value which will uniquely identify the specific request that was made. This ensures uniqueness even if the patient was referred to the CIE multiple times.

    HTTP Status Code

    Description

    HTTP Status Code

    Description

    201

    Successful creation of a service request.

     

    403

    Request is unauthorized and will not be processed. This will happen if the authorization header does not contain a valid client id and secret.

     

    400

    Request is malformed and will not be processed.

     

    Example CURL for this API Call

    The following is an example CURL for calling this api. Also note that there are sample Referral Id’s that are in the CIE Hub development environment that can be used for testing purposes

     

    curl -v --request POST 'https://fhir.{baseCIEURL}.org/SeviceRequest/' --header 'x-api-key: aGZoczo4****2ZDk=' --header 'Content-Type: application/json' --header 'Authorization: bearer etty****iquerui' -- data @SERVICEREQUEST.JSON  

    Â