API РЕСУРСЫ

Қабылдау & Күнтізбе

Дәрігер мен креслоға негізделген жоспарлау, қосарланған брондауды болдырмау, автоматты еске салу және күту тізімі. Қабаттасу дерекқор деңгейінде болдырылмайды.

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

Ұштар

10 ұш

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

GET /v1/appointments Қабылдауларды күн аралығы бойынша тізімдейді Барлық өкілетті рөлдер

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

POST /v1/appointments/{id}/status Қабылдау жай-күйін өзгертеді admin · хатшы · дәрігер

POST /v1/appointments/{id}/reschedule Қабылдауды қайта жоспарлайды admin · хатшы · дәрігер

POST /v1/appointments/{id}/remind Қабылдау еске салуын жібереді admin · хатшы · дәрігер

GET /v1/units Кресло/бірліктерді тізімдейді Барлық өкілетті рөлдер

GET /v1/doctors Дәрігерлерді тізімдейді Барлық өкілетті рөлдер

GET /v1/waitlist Күту тізімін алады Барлық өкілетті рөлдер

POST /v1/waitlist Күту тізіміне науқас қосады admin · хатшы · дәрігер

DELETE /v1/waitlist/{id} Күту тізімінен шығарады admin · хатшы · дәрігер

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

Күн аралығы бойынша қабылдауларды алу

Сұраныс

curl https://api.udentiva.com/v1/appointments?from=2026-06-24&to=2026-06-25 \
  -H "Authorization: Bearer udk_live_xxx"

Жауап

HTTP/1.1 200 OK
[
  {
    "id": "a1b2...",
    "patient_id": "c0ffee00-...",
    "unit_id": "u-1",
    "starts_at": "2026-06-24T10:00:00Z",
    "ends_at": "2026-06-24T10:30:00Z",
    "status": "confirmed"
  }
]

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

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

Қосарланған брондау exclusion constraint арқылы дерекқор деңгейінде мүмкін емес; қолданба қатесі болса да қабаттасатын қабылдау жазылмайды.

Бір мезгілдегі слот бәсекесі Redis үлестірілген құлпымен болдырылмайды; бір слотқа екі сұраныс бір уақытта жаза алмайды.

Барлық қабылдау деректері клиникаңызға оқшауланған (RLS); жай-күй өзгерістері тексеру жазбасына енгізіледі.

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

Қате Форматы

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

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

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

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

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

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

Байланысу