Get Device request context

Purpose

This method allows to get the context of a Device request in order to create approval on episode and receive access to other medical events.

Specification

Apiary

Authorization

• Verify the validity of access token

  • Return (401, 'Invalid access token') in case of validation fails

• Verify that token is not expired

  • in case of error - return (401, 'Invalid access token')

• Check user scopes in order to perform this action (scope = 'medical_event_context:read')

  • Return (403, 'Your scope does not allow to access this resource. Missing allowances: medical_event_context:read') in case of invalid scope(s)

Validations

Validate Person

• Get Person identifier from the URL

• Check it exists in DB

  • Return 404 ('not_found') in case of error

Validate Device request

• Get Device request identifier from the URL

  • Check it exists in DB

    • Return 404 ('not_found') in case of error

  • Check Device request belongs to patient

    • Return 404 ('not_found') in case of error

Service logic

Service returns context (episode) of the Device request based on:

• Get Device request object by device_request_id from MongoDB

  • Get device_requests.context_episode_id from Device request object

  • Get device_requests.based_on[*].identifier.value from Device request object where code=care_plan

• Render a response according to specification