Table of Contents

Purpose

This method allows you to add a role to an employee according to the type of medical service for which the role is being added.

...

Page Properties

id	API_Specification

Link	eHealth MIS API · Apiary	Посилання на Apiary або Swagger
Resource	/api/employee_roles	Посилання на ресурс, наприклад: /api/persons/create
Scope	employee_role:write	Scope для доступу
Components	Scopes modelEmployees	Зазначається перелік бізнес компонентів, які використовують цей метод, наприклад: ePrescription
Microservices	API paragraph not foundil/api	Перелік мікросервісів, які використовує метод API, наприклад: Auth, ABAC
Protocol type	REST	Тип протоколу, який використовується запитом, наприклад: SOAP \| REST
Request type	POST	Тип запиту API, наприклад: GET, POST, PATCH…
Sync/Async	Sync	Метод є синхронним чи асинхронним?
Public/Private/Internal	Public	Потрібно зазначити тип методу за ступенем доступності

Logic

Only authenticated and authorized user can use this service
Employee role must be valid and consistent, i.e. all "foreign keys" must be valid
It can be only one active employee_role for the single employee and healthcare service

...

Verify the validity of access token
Return
- return 401 in case validation fails
Check scopes in order to perform this action (scope = 'employee_role:write')
Return
- return 403 in case invalid scope(s)
If BLOCK_UNVERIFIED_PARTY_USERS is true, then check party's data match following condition: verification_status != NOT_VERIFIED or (verification_status = NOT_VERIFIED and updated_at <= current_date - UNVERIFIED_PARTY_PERIOD_DAYS_ALLOWED):
- in case not match - return 403 ("Access denied. Party is not verified")

Наприклад:

...

Parameter	Source	Description
id	UUID	Autogenerated
start_date	Timestamp: now()	Get current date-time
status	Const: ACTIVE	By default ACTIVE for new records
is_active	Const: TRUE	Always TRUE for new records
inserted_at	Timestamp: now()	Get current date-time
inserted_by	Token: user_id	Extract user from token
updated_at	Timestamp: now()	Get current date-time
updated_by	Token: user_id	Extract user from token

Example:

...