Page tree
Skip to end of metadata
Go to start of metadata


Вступ

АРІ інтерфейс використовується для того, щоб ДМІС та сервіси неголосового виклику могли обмінюватися інформацією та даними з ІАС «Централь103» (далі – Централь103).

REST API ІАС «Централь103» працює за протоколом HTTPS і представлений набором методів, за допомогою якого створюються запити та повертаються відповіді для кожної операції. Всі відповіді приходять у формі JSON структур.

Історія оновлень

ДатаДеталі оновлення
130.09.2019
  1. Додано перелік медичного обладання ЦЕМД
  2. Додано штатний розпис ЦЕМД
  3. Додано поле staff::workload - ставка працівника
  4. Додано можливість визначати керівника бригади
  5. Реалізовано метод "Intercall" y СallСard put запиті
203.10.2019
  1. Додано "Класифікатор викликів"

Основний URL

Усі посилання на запити до АРІ в даній документації включають обов’язковий основний URL Централь103:

https://central103.org

Основний час та часові мітки

Централь103 використовує часові мітки у форматі ISO 8601 без зазначення часового поясу. Час в Централь103 дорівнює Київському часу.

Аутентифікація та авторизація

Централь103 використовує механізм аутентифікації, що базується на стандарті JSON Web Token (JWT). Процес аутентифікації можливий лише за наявності персональної пари ключа.

Для аутентифікації необхідно відправити POST запит за посиланням:

URL: https://central103.org/api/auth/login/

Параметри запиту: {"username": "<username>", "password": "<password>"}

Якщо аутентифікація пройшла успішна буде повернуто токен авторизації (ключ).

Приклад відповіді сервера на запит отримання токена:
{
"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VylkIjoyLCJ1c2VybmFtZSI6Im1pc2t5aXYiLCJleHAiOjE1MzM1NDU4MjksImVtYWlsIjoiIn0.b67wPQxtSUrVTSDGGSIEJPZGUB9BTyfSgdH93eXBiBRQk"
}

Код ключа повинен передаватися в заголовці (в “headers”) кожного наступного запиту, окрім випадків надсилання запитів на отримання самого токена, коли цей код не потрібний.

Приклад ключа, що додається в заголовок повідомлення:

'Authorization': 'JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VylkIjoyLCJ1c2VybmFtZSI6Im1pc2t5aXYiLCJleHAiOjE1MzM1NDU4MjksImVtYWlsIjoiIn0.b67wPQxtSUrVTSDGGSIEJPZGUB9BTyfSgdH93eXBiBRQk'

Отриманий ключ діє протягом 24 годин і не вимагає повторного запиту при кожній операції. Під час тестового періоду в рамках тестування тривалість дійсності токена може змінюватися. Центаль103 надішле наступну відповідь:

HTTP 401 Unauthorised
BODY:
{"detail": "Signature has expired."}

Після закінчення строку дії токена необхідно повторити аутентифікацію – відправити повторний запит на отримання ключа.

HeartBeat

Незалежно від того чи відбуваються якісь операції, ДМІС кожні 10 секунд повинна надсилати POST “HeartBeat” запит в Централь103 за посиланням:

URL: https://central103.org/api/heartbeat/

Параметри “HeartBeat” запиту:

#

Поле

Null

Порожнє

Тип

Опис

1

mis_id

False

false

char[16]

Ідентифікаційний код ОДС, що надсилає запит в Централь103

2

mis_heartbeat

False

False

datetime

Часова мітка формування “HeartBeat”

3

timestamp

False

False

datetime

Часова мітка відповіді на “HeartBeat”

 

Приклад “HeartBeat” запиту:
{
  "Heartbeat":
  [
    {
      "mis_heartbeat": "2018-08-05T12:01:24.044302"
    }
  ]
}

У відповідь сервер повертає повідомлення з наступними параметрами:

Приклад відповіді:
{
 "Heartbeat": [
  {
   "mis_id": 1,
   "mis_heartbeat": "2018-08-05T12:01:24.044302",
   "timestamp": "2018-08-05T12:01:24.125149"
  }
 ]
}

У випадку проведення інтерконекту до відповіді буде доданий параметр “Intercall”.

  • No labels
Write a comment…