API РЕСУРСЫ

Одонтограмма & Емдеу

FDI тіс картасы, қызмет/әрекет каталогы, кезеңдік емдеу жоспары және рецепт. Тіс жай-күйлері append-only сақталады — тарих жойылмайды, үстіне жазылмайды.

Ерте Қатынау Барлық API

Ұштар

14 ұш

Бұл ресурсқа тиесілі ұштар. Әр ұш API кілті байланысты клиника дерегімен шектелген; жазу ұштары Idempotency-Key тақырыпшасын қолдайды.

GET /v1/patients/{id}/odontogram Ағымдағы FDI тіс картасын алады Барлық өкілетті рөлдер

POST /v1/patients/{id}/odontogram Тіс жай-күйін қосады (append-only) admin · дәрігер

GET /v1/patients/{id}/odontogram/{tooth}/history Тістің жай-күй тарихын алады Барлық өкілетті рөлдер

GET /v1/services Қызмет/әрекет каталогын тізімдейді Барлық өкілетті рөлдер

POST /v1/services Қызмет бабын қосады admin

PUT /v1/services/{id} Қызмет бабын жаңартады admin

GET /v1/patients/{id}/plans Науқастың емдеу жоспарларын тізімдейді Барлық өкілетті рөлдер

POST /v1/patients/{id}/plans Емдеу жоспарын жасайды admin · дәрігер

GET /v1/plans/{id} Емдеу жоспары толығын алады Барлық өкілетті рөлдер

POST /v1/plans/{id}/status Жоспар жай-күйін өзгертеді admin · дәрігер

POST /v1/plans/{id}/items Жоспарға кезең/баб қосады admin · дәрігер

POST /v1/plan-items/{id}/status Жоспар бабының жай-күйін өзгертеді admin · дәрігер

GET /v1/patients/{id}/prescriptions Рецепттерді тізімдейді Барлық өкілетті рөлдер

POST /v1/patients/{id}/prescriptions Рецепт жасайды admin · дәрігер

Қолдану Мысалы

Тіс жай-күйін қосу (append-only)

Сұраныс

curl -X POST https://api.udentiva.com/v1/patients/{id}/odontogram \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tooth":"11","state":"caries","surface":"mesial"}'

Жауап

HTTP/1.1 201 Created
{
  "id": "st-77",
  "tooth": "11",
  "state": "caries",
  "recorded_at": "2026-06-24T09:10:00Z"
}

Бұл ресурстағы қауіпсіздік

Қауіпсіздік — мүмкіндік емес, сәулеттің өзі. Бұл ресурста қолданылатын кепілдіктер:

Тіс жай-күйінің жазбалары append-only болып табылады: әрбір өзгеріс жаңа жол ретінде қосылады, ескі жазба өзгертілмейді (клиникалық тарих тұтастығы).

Емдеу жоспарын және рецепт жасау тек admin/дәрігер рөліне ашық; баға және кезең логикасы серверде орындалады.

Барлық жазбалар клиникаңызға оқшауланған; жоспар-баға есептеулері клиенттен алынбайды, серверде numeric арқылы жасалады.

Бүкіл қауіпсіздік моделі →

Қате Форматы

Қателер тұрақты конвертпен қайтарылады; код машинаға, хабар қолданушыға арналған. Ішкі қате/стек ешқашан сызылмайды.

{
  "error": {
    "code": "validation_failed",
    "message": "Жарамсыз өріс: электрондық пошта"
  }
}

Басқа Ресурстар

Науқастар Қабылдау & Күнтізбе Төлем және Қаржы Қор Бейнелеу Зертхана Lead & CRM Медициналық туризм Есеп беру & BI Webhooks Деректерді Тасымалдау (Export API)

Ерте қатынау қалайсыз ба?

API ашылғанда алдымен сіз хабардар болыңыз.

Байланысу