ЕСОЗ - публічна документація
Get Procedure contexts
Purpose
This method allows to get contexts of Procedure in order to create approval on episode and receive access to other medical events.
Specification
Link | |
Resource | /api/patients/{{patient_id}}/procedures/{{procedure_id}}/context |
Scope | medical_event_context:read |
Components | EDP |
Microservices | API paragraph not found |
Protocol type | REST |
Request type | GET |
Sync/Async | Async |
Public/Private/Internal | Public |
Logic
Service returns contexts (episode and origin_episode), procedure based on:
Get Procedure object by procedure_id from procedures (MongoDB)
Get procedure.encounter.identifier from Procedure object
Call Get Encounter context :
Get Encounter object by procedure.encounter.identifier (procedure.encounter.identifier = encounter._id)
AFTERGet encounter.episode from Encounter object
Get procedure.origin_episode from Procedure object
Render a response according to specification
Input parameters
Input parameter | Values | Type | Description | Example |
---|---|---|---|---|
patient_id |
| String | Patient identifier |
|
procedure_id |
| String | Procedure identifier |
|
Request structure
See on Apiary
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 = '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)
Headers
Content-Type:application/json
Authorization:Bearer mF_9.B5f-4.1JqM
Request data validation
Validate Person
Get Person identifier from the URL
Check it exists in DB
Return 404 ('not_found') in case of error
Validate Encounter
Get Procedure identifier from the URL
Check it exists in DB
Return 404 ('not_found') in case of error
Check Procedure belongs to patient
Return 404 ('not_found') in case of error
Processing
API paragraph not found
Response structure*
See on Apiary
Post-processing processes
API paragraph not found
HTTP status codes
HTTP status code | Message | What caused the error |
---|---|---|
200 |
|
|
ЕСОЗ - публічна документація