API РЕСУРСЫ

Науқастар

Науқас файлы: демографиялық ақпарат, анамнез/аллергия, медициналық тарих және құжаттар. Әрбір жазба клиникаңызға оқшауланған; жою операциясы қайтарылатын мұрағаттау болып табылады (hard-delete жоқ).

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

Ұштар

9 ұш

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

GET /v1/patients Науқастар тізімін беттелген түрде алады Барлық өкілетті рөлдер

POST /v1/patients Жаңа науқас жазбасын жасайды admin · хатшы · дәрігер

GET /v1/patients/{id} Бір науқастың толығын алады Барлық өкілетті рөлдер

PUT /v1/patients/{id} Науқас ақпаратын жаңартады admin · хатшы · дәрігер

DELETE /v1/patients/{id} Науқасты мұрағаттайды (soft-delete) admin

GET /v1/patients/{id}/medical Анамнезді, аллергияны және медициналық тарихты тізімдейді Барлық өкілетті рөлдер

POST /v1/patients/{id}/medical Медициналық/анамнез жазбасын қосады admin · дәрігер

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

POST /v1/patients/{id}/documents Науқасқа құжат қосады admin · хатшы

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

Жаңа науқас жасау

Сұраныс

curl -X POST https://api.udentiva.com/v1/patients \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: 9f1c2e7a-..." \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ayse","last_name":"Yilmaz","phone":"+90555..."}'

Жауап

HTTP/1.1 201 Created
{
  "id": "c0ffee00-1234-...",
  "first_name": "Ayse",
  "last_name": "Yilmaz",
  "phone": "+90555...",
  "created_at": "2026-06-24T09:00:00Z"
}

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

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

Деректер оқшаулауы: барлық науқас сұраныстары кілт байланысқан клиникамен жол деңгейінде (RLS) шектелген; басқа клиниканың науқасы ешқашан қайтарылмайды.

Рөлге негізделген өкілеттік: жасау/жаңарту admin, хатшы немесе дәрігер; жою тек admin. Өкілеттік API қабатында мәжбүрленеді.

Құпия деректер (TCKN, денсаулық деректері) бүркеленеді және тексеру жазбасына шикі түрде жазылмайды.

Жою = soft-delete (deleted_at); жазба анонимделеді, физикалық түрде жойылмайды (KVKK үйлесімді).

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

Қате Форматы

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

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

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

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

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

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

Байланысу