РЕСУРС API

Одонтограмма и лечение

Зубная карта FDI, каталог услуг/процедур, поэтапный план лечения и рецепт. Состояния зубов ведутся в режиме append-only — история не удаляется и не перезаписывается.

Ранний доступ Весь API

Конечные точки

14 конечная точка

Конечные точки этого ресурса. Каждая точка ограничена данными клиники, к которой привязан ключ API; точки записи поддерживают заголовок Idempotency-Key.

GET /v1/patients/{id}/odontogram Возвращает актуальную зубную карту FDI Все авторизованные роли

POST /v1/patients/{id}/odontogram Добавляет состояние зуба (append-only) admin · врач

GET /v1/patients/{id}/odontogram/{tooth}/history Возвращает историю состояний зуба Все авторизованные роли

GET /v1/services Выводит каталог услуг/процедур Все авторизованные роли

POST /v1/services Добавляет позицию услуги admin

PUT /v1/services/{id} Обновляет позицию услуги admin

GET /v1/patients/{id}/plans Выводит список планов лечения пациента Все авторизованные роли

POST /v1/patients/{id}/plans Создаёт план лечения admin · врач

GET /v1/plans/{id} Возвращает детали плана лечения Все авторизованные роли

POST /v1/plans/{id}/status Изменяет статус плана admin · врач

POST /v1/plans/{id}/items Добавляет этап/позицию в план admin · врач

POST /v1/plan-items/{id}/status Изменяет статус позиции плана admin · врач

GET /v1/patients/{id}/prescriptions Выводит список рецептов Все авторизованные роли

POST /v1/patients/{id}/prescriptions Создаёт рецепт admin · врач

Пример использования

Добавить состояние зуба (append-only)

Запрос

curl -X POST https://api.udentiva.com/v1/patients/{id}/odontogram \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tooth":"11","state":"caries","surface":"mesial"}'

Ответ

HTTP/1.1 201 Created
{
  "id": "st-77",
  "tooth": "11",
  "state": "caries",
  "recorded_at": "2026-06-24T09:10:00Z"
}

Безопасность этого ресурса

Безопасность — не функция, а сама архитектура. Гарантии, действующие на этом ресурсе:

Записи состояний зуба ведутся в режиме append-only: каждое изменение добавляется новой строкой, старая запись не может быть изменена (целостность клинической истории).

Создание плана лечения и рецепта доступно только роли admin/врач; логика цен и этапов исполняется на сервере.

Все записи изолированы в вашей клинике; расчёты цен плана не берутся с клиента, а выполняются на сервере в numeric.

Вся модель безопасности →

Формат ошибки

Ошибки возвращаются в согласованном конверте; код — для машины, сообщение — для пользователя. Внутренняя ошибка/стек никогда не утекает.

{
  "error": {
    "code": "validation_failed",
    "message": "Недопустимое поле: e-mail"
  }
}

Другие ресурсы

Пациенты Записи на приём и календарь Инкассация и финансы Склад Снимки Лаборатория Lead и CRM Медицинский туризм Отчётность и BI Webhooks Передача данных (Export API)

Хотите ранний доступ?

Узнайте об открытии API первыми.

Связаться