Table of Contents

Purpose

This WS is designed to return Device request details by identifier.

Specification

Page Properties

id	API_Specification

Link

https://ehealthmedicaleventsapi.docs.apiary.io/#reference/device-requests/get-device-request-details/get-device-request-details

Посилання на Apiary

...

або Swagger
Resource	/api/patients/{{patient_id}}/device_requests/{{device_request_id}}	Посилання на ресурс, наприклад: /api/persons/create
Scope	`device_request:read`	Scope для доступу
Components		Зазначається перелік бізнес компонентів, які використовують цей метод, наприклад: ePrescription
Microservices		Перелік мікросервісів, які використовує метод API, наприклад: Auth, ABAC
Protocol type		Тип протоколу, який використовується запитом, наприклад: SOAP \| REST
Request type	GET	Тип запиту API, наприклад: GET, POST, PATCH…
Sync/Async		Метод є синхронним чи асинхронним?
Public/Private/Internal		Потрібно зазначити тип методу за ступенем доступності

Logic

Service returns specified Device requests related to the patient:

Get Device requests from device_request collection (MongoDB)
Validate data consistency:
1. Ensure that requested Device requests relates to requested Patient (from URL)
  1. Return 403 ('Access denied') in case of error
Fill in urgent block with current authentication method and verification_code field:
1. If person has OTP authentication method, then set phone_number and verification_code=null
2. If person has OFFLINE authentication method, then set verification_code and phone_number=null
Render a response according to specification

Input parameters

Input parameter	Values	Type	Description	Example
patient_id		String	Unique patient identifier	`7075e0e2-6b57-47fd-aff7-324806efa7e5`
device_request_id		String	Unique device request identifier	`aff00bf6-68bf-4b49-b66d-f031d48922b3`

Request structure

API paragraph not found

Authorize

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 = 'device_request:read')
- Return (403, 'Your scope does not allow to access this resource. Missing allowances: device_request:read') in case of invalid scope(s)

Access to the resource is also managed by ABAC rules.

Service logic

Service returns specified Device requests related to the patient:

...

Get Device requests from device_request collection (MongoDB)

...

Validate data consistency:

Ensure that requested Device requests relates to requested Patient (from URL)
1. Return 403 ('Access denied') in case of error

...

Fill in urgent block with current authentication method and verification_code field:

If person has OTP authentication method, then set phone_number and verification_code=null
If person has OFFLINE authentication method, then set verification_code and phone_number=null

...

Headers

Content-Type:application/json
Authorization:Bearer mF_9.B5f-4.1JqM
api-key:aFBLVTZ6Z2dON1V

Request data validation

API paragraph not found

Processing

API paragraph not found

Response structure

See on Apiary

Example:

Expand

title	Response example

Code Block

{
  "data": {
    "id": "90a9e15b-b71b-4caf-8f2e-ff247e8a5600",
    "intent": "order",
    "code": {
      "coding": [
        {
          "system": "device_definition_classification_type",
          "code": "30221"
        }
      ]
    },
    "quantity": {
      "value": 10,
      "system": "device_unit",
      "code": "piece",
      "unit": "шт"
    },
    "encounter": {
      "identifier": {
        "type": {
          "coding": [
            {
              "system": "eHealth/resources",
              "code": "encounter"
            }
          ]
        },
        "value": "9183a36b-4d45-4244-9339-63d81cd08d9c"
      },
      "display_value": "null"
    },
    "reason": [
      {
        "identifier": {
          "type": {
            "coding": [
              {
                "system": "eHealth/resources",
                "code": "condition"
              }
            ]
          },
          "value": "9183a36b-4d45-4244-9339-63d81cd08d9c"
        },
        "display_value": "null"
      }
    ],
    "requester": {
      "identifier": {
        "type": {
          "coding": [
            {
              "system": "eHealth/resources",
              "code": "employee"
            }
          ]
        },
        "value": "b4a6d991-0bf7-476f-b3cf-bec83f044b1b"
      },
      "display_value": "Мельник Микола Микитович"
    },
    "authored_on": "2000-01-01T00:00:00.000Z",
    "occurrence_period": {
      "start": "2000-01-01T00:00:00.000Z",
      "end": "2018-08-02T11:00:00.000Z"
    },
    "status": "active",
    "status_reason": {
      "coding": [
        {
          "system": "device_request_revoke_reasons",
          "code": "incorrect_patient"
        }
      ]
    },
    "subject": {
      "identifier": {
        "type": {
          "coding": [
            {
              "system": "eHealth/resources",
              "code": "patient"
            }
          ]
        },
        "value": "9183a36b-4d45-4244-9339-63d81cd08d9c"
      },
      "display_value": "null"
    },
    "requester_legal_entity": {
      "identifier": {
        "type": {
          "coding": [
            {
              "system": "eHealth/resources",
              "code": "legal_entity"
            }
          ]
        },
        "value": "c5a6d991-0bf7-476f-b3cf-bec83f044b2a"
      },
      "display_value": "Комунальне підприємство Медлаб"
    },
    "program": {
      "identifier": {
        "type": {
          "coding": [
            {
              "system": "eHealth/resources",
              "code": "medical_program"
            }
          ]
        },
        "value": "c5a6d991-0bf7-476f-b3cf-bec83f044b2a"
      },
      "display_value": "Доступні медичні вироби"
    },
    "requisition": "AX65-4654-TІВ1-ТВТ1",
    "dispense_valid_to": "2018-08-02T10:45:16.000Z",
    "note": "Some notes",
    "inserted_at": "2018-08-02T10:45:16.000Z",
    "updated_at": "2018-08-02T10:45:16.000Z"
  },
  "meta": {
    "code": 200,
    "url": "http://example.com/resource",
    "type": "object",
    "request_id": "req-adasdoijasdojsda"
  },
  "urgent": {
    "authentication_method_current": {
      "type": "OTP",
      "number": "+38093*****85"
    },
    "verification_code": "1234"
  }
}

Expand

title	Response example

Code Block
{ "meta": { "code": 404, "url": "http://example.com/resource", "type": "object", "request_id": "req-adasdoijasdojsda" }, "error": { "type": "NOT_FOUND", "message": "Device request not found" } }

Post-processing processes

API paragraph not found

HTTP status codes

Page Properties

id	API_HTTP status codes

HTTP status code	Message	What caused the error
200
404

Versions Compared

Old Version 1

New Version 2

Key

Purpose

Specification

Logic

Input parameters

Request structure

Authorize

Service logic

Headers

Request data validation

Processing

Response structure

Post-processing processes

HTTP status codes

Page Comparison

Versions Compared

Old Version 1

New Version 2

Key

Purpose

Specification

Logic

Input parameters

Request structure

Authorize

Service logic

Headers

Request data validation

Processing

Response structure

Post-processing processes

HTTP status codes