Purpose

This WS allows to get a single Specimen by its identifier.

Specification

Key points

1. Only authenticated and authorized employee with appropriate scope can get a Specimen.

2. Method returns a single Specimen that belongs to the specified patient.

3. ABAC rules are used here

Logic

RC._Процеси роботи зі зразком біоматеріалу | Отримання інформації Зразка при взаємодії з пацієнтом

Service returns specified Specimen related to the patient:

• Get Specimen by ID from specimens collection (MongoDB)

• Render a response according to specification

Filters

Request structure

See on Apiary

Authorization

• Verify the validity of access token

  • in case of error - 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 and client scopes in order to perform this action (scope = 'specimen:read')

  • return 403 “Your scope does not allow to access this resource. Missing allowances: specimen:read” in case of invalid scope(s)

• Access to the resource is also managed by ABAC module

Headers

• Content-Type:application/json

• Authorization:Bearer mF_9.B5f-4.1JqM

• api-key:aFBLVTZ6Z2dON1V

• X-Custom-PSK:a2aa05c76f3f2d91870f923a53cc8aa8f23bbc01a8238d1c2c26d4299715a7e4

Request data validation

Validate Patient

• Get Patient identifier from the URL

• Check it exists in DB

  • Return 404 ('not found') in case of error

Validate Specimen

• Get Specimen identifier from the URL

• Check it exists in DB

  • Return 404 ('not found') in case of error

• Check Specimen belongs to patient

  • Return 404 ('not found') in case of error

Response structure

See on Apiary

HTTP status codes