API РЕСУРСЫ

Есеп беру & BI

Табысты, толымдылықты, конверсияны және пайдалылық метрикаларын нақты уақытта алыңыз. Барлық сандар клиникаңыздың нақты деректерінен туындатылады.

Ұштар

3 ұш

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

GET /v1/bi Бизнес аналитикасы метрикаларын алады admin · басқарушы

GET /v1/profit Пайдалылық есебін алады admin · басқарушы

GET /v1/rcm Табыс циклі (RCM) метрикаларын алады admin · басқарушы

Бизнес аналитикасы метрикаларын алу

Сұраныс

curl https://api.udentiva.com/v1/bi?period=2026-06 \
  -H "Authorization: Bearer udk_live_xxx"

Жауап

HTTP/1.1 200 OK
{
  "occupancy": 0.78,
  "no_show_rate": 0.06,
  "collected": "248500.00"
}

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

Есеп ұштары тек оқуды орындайды; клиникаңызға оқшауланған, туындатылған метрикаларды қайтарады.

Жинақталған сандар; шикі науқас деректері есеп ұштарында жолма-жол ашылмайды.

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

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

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

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