Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel3

Purpose

This method intended to get all Devices in patient context by params

This web service is designed to return records about patient's devices by patient_id or search_params.

Specification

Page Properties

Link

https://medicaleventsmisapi.docs.apiary.io/#reference/medical-events/device/get-devices-by-search-params

Resource

/api/patients/{{patient_id}}/devices

Scope

device:read

Components

API paragraph not found

Microservices

API paragraph not found

Protocol type

REST

Request type

GET

Sync/Async

Async

Public/Private/Internal

Public

Logic

...

Service returns specified all Devices in patient context:

  • Get data from devices (MongoDB)

  • Filter list above by submitted search parameters

    • It must be allowed to pass multiple comma-separated values for some query parameters:

      • type

      • definition

      • status

  • Sorting by inserted_at desc

  • Render a response according to specification.

Filters

Filter

Values

Type

Description

Example

page

Number

Page number

2

page_size

Number

A limit on the number of objects to be returned, between 1 and 100. Default: 50

50

type

String

spine_board

encounter_id

String

09dc3ed7-2169-45d8-8fa3-d918c6839bf9

episode_id

String

09dc3ed7-2169-45d8-8fa3-d918c6839bf9

asserted_date_from

String

1990-01-01

asserted_date_to

String

2000-01-01

Request structure

API paragraph not found

...

Request to process the request using a token in the headers

Headers

Наприклад:

  • Content-Type:application/json

  • Authorization:Bearer mF_9.B5f-4.1JqM

...

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

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

Access to the resource is also managed by ABAC module

Validate Patient

  • Get Person identifier from the URL

    • Check it exists in DB

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

Processing

API paragraph not found

...

API paragraph not found

HTTP status codes

HTTP status code

Message

What caused the error

 200