...

...

...

Status

...

Purpose

This WS is designed to create new innm (post).

APIary 

create-innm

Input parameters 

...

Purpose

This WS is designed to create new innm dosage (post).

Specification

Logic

This method is used to create INNM Dosage. Fields descriptions are listed in request Example view.

Request structure

See on Apiary

Example:

{
  "name": "Амідарон",
  "form": "PILL",
  "ingredients": [
    {
      "id": "1349a693-4db1-4a3f-9ac6-8c2f9e541982",
      "dosage": {
        "numerator_unit": "MG",
        "numerator_value": 200,
        "denumerator_unit": "PILL",
        "denumerator_value": 1
      },
      "is_primary": true
    }
  ]
}

Authorize

1. Verify the validity of access token

2. Check user scope (scope = '

...

1. innm_dosage:write') in order to perform this action

   1. In case error - generate 401 response

Validate request (JSON schema)

...

Request to process the request using a token in the headers

Headers

Наприклад:

• Content-Type:application/json

• Authorization:Bearer c2778f3064753ea70de870a53795f5c9

Request data validation

Validate FK 

Purpose validation: Check on existing SubstanceInmm/Innm dosage in ingredients 

1. For Check exist

...

1. `Innm` by $.ingredients[].id.

   1. if invalid - return 422 error (message: "

...

1. 1. Innm in ingredients is not found!")

Validate status

...

Purpose validation: Id's

...

in ingredients must be active  

1. Invoke

...

1. GetInnmByID($.ingredients[].id). Check exist any

...

1. innm.is_active=FALSE.

   1. if exists - return 422 error (message: "

...

1. 1. Innm in ingredients must be active!")

Validate status ingredients.is_

...

primary

Purpose validation:  in ingredients only one

...

item must be is active

...

innm (TRUE)  

1. Calc count() where is_

...

1. primary=TRUE in ingredients. Check count()=1.

   1. if invalid - return 422 error (message: "One of ingredients must be

...

1. 1. primary!")

Validate innm duplication

Purpose validation: in ingredients innms can't be duplicated. Innms id has to be unique

1. Check uniqueness of $.ingredients[].id.

   1. if invalid - return 422 error (message: "Ingredients can't be duplicated")

Validate request

1. Validate request using JSON schemas (new_medication_type_innm_dosage_schema.json):

   1. Return 422 with list of validation errors in case validation fails (422 EView)

Processing

Create new Medication

1. Create new record in

...

1. Medications

2. Fill data 

Create new Ingredients

1. Save `id` of new Medication into var `med_id` 

2. Create new record in Ingredients from $.ingredients

3. Delete all Ingredients where parent_id

...

Prepare & return response data structure

...

1. = 

2. Fill data (where `Ing` = $.ingredients) 

Response structure

See on Apiary

Example:

{
  "meta": {
    "code": 201,
    "url": "https://example.com/resource",
    "type": "object",
    "request_id": "req-adasdoijasdojsda"
  },
  "data": {
    "id": "09b2bffb-699a-43c0-bc9a-5066d9b9b5a8",
    "name": "Амідарон",
    "form": "PILL",
    "ingredients": [
      {
        "id": "1349a693-4db1-4a3f-9ac6-8c2f9e541982",
        "name": "Амідарон",
        "dosage": {
          "numerator_unit": "MG",
          "numerator_value": 200,
          "denumerator_unit": "PILL",
          "denumerator_value": 1
        },
        "is_primary": true
      }
    ],
    "is_active": true,
    "inserted_at": "2017-04-20T19:14:13Z",
    "inserted_by": "e1453f4c-1077-4e85-8c98-c13ffca0063e",
    "updated_at": "2017-04-20T19:14:13Z",
    "updated_by": "2922a240-63db-404e-b730-09222bfeb2dd"
  }
}

{
  "meta": {
    "code": "422",
    "url": "https://example.com/resource",
    "type": "object",
    "request_id": "req-adasdoijasdojsda"
  },
  "error": {
    "type": "unverified",
    "message": "Property \"is_active\" has not been defined and the schema does not allow additional properties!"
  }
}

HTTP status codes