API RESOURCE

库存

Stock item, in/out movement and critical-level alert. Movements are on record; the balance is derived from movements.

Endpoints

6 endpoint

Endpoints for this resource. Every endpoint is scoped to the clinic data the API key is bound to; write endpoints support the Idempotency-Key header.

GET /v1/stock Lists stock items All authorized roles

GET /v1/stock/critical Lists stock at critical level All authorized roles

POST /v1/stock Creates a stock item admin

PUT /v1/stock/{id} Updates the stock item admin

POST /v1/stock/{id}/movement Adds a stock movement (in/out) admin · secretary

GET /v1/stock/{id}/movements Lists stock movements All authorized roles

Pull critical stock

Request

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

Response

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

Security isn't a feature, it's the architecture itself. The guarantees that apply to this resource:

Stock item creation/update by admin; adding movements by admin/secretary. All data is isolated to your clinic.

Stock movements are record-based; corrections are made with a reversing movement, and history is never deleted.

Errors are returned in a consistent envelope; the code is for the machine, the message for the user. Internal error/stack is never leaked.

{
  "error": {
    "code": "validation_failed",
    "message": "Invalid field: email"
  }
}

Want early access?

Be the first to know when the API opens.