...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Specification

...

...

...

Purpose

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

Input parameters 

• name
• form
• ingredients (array)
  • id
  • dosage info
  • is_aprimary

...

Required parameters are marked with "*"

Якщо інформації по відповідному параметру немає, потрібно зазначити: “APIparagraph not found”.

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 = '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 Inmm/Innm dosage in ingredients 

...

Validate status

Purpose validation: Id's in ingredients must in ingredients must be active  

1. Invoke GetInnmByID($.ingredients[].id). Check exist any innm.is_active=FALSE.

   1. if exists - return 422 error (message: "Innm in ingredients must be active!")

Validate status ingredients.is_primary

Purpose validation:  in ingredients only one item must item must be is active innm (TRUE)  

1. Calc count() where is_primary=TRUE in ingredients. Check count()=1.

   1. if invalid - return 422 error (message: "One of ingredients must be 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 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 = 

4. 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!"
  }
}

Post-processing processes*

API paragraph not found

HTTP status codes*