API РЕСУРСЫ

Қор

Қор картасы, кіріс/шығыс қозғалысы және сыни деңгей ескертуі. Қозғалыстар жазбаға алынады; баланс қозғалыстардан туындатылады.

Ұштар

6 ұш

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

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

GET /v1/stock/critical Сыни деңгейдегі қорларды тізімдейді Барлық өкілетті рөлдер

POST /v1/stock Қор картасын жасайды admin

PUT /v1/stock/{id} Қор картасын жаңартады admin

POST /v1/stock/{id}/movement Қор қозғалысын (кіріс/шығыс) қосады admin · хатшы

GET /v1/stock/{id}/movements Қор қозғалыстарын тізімдейді Барлық өкілетті рөлдер

Сыни қорларды алу

Сұраныс

curl https://api.udentiva.com/v1/stock/critical \
  -H "Authorization: Bearer udk_live_xxx"

Жауап

HTTP/1.1 200 OK
[
  {
    "id": "itm-12",
    "name": "Kompozit A2",
    "on_hand": 3,
    "critical_level": 5
  }
]

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

Қор картасын жасау/жаңарту admin; қозғалыс қосу admin/хатшы. Барлық деректер клиникаңызға оқшауланған.

Қор қозғалыстары жазба-негізді; түзету кері қозғалыспен жасалады, тарих жойылмайды.

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

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

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

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