РЕСУРС API

Lead и CRM

Собирайте входящие запросы (lead) в едином пуле; отслеживайте задачи, звонки и коммуникацию с пациентами. Ни один интерес не должен потеряться по пути.

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

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

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

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

GET /v1/leads Выводит список lead/запросов Авторизованный пользователь

POST /v1/leads Создаёт новый lead Авторизованный пользователь

POST /v1/leads/{id}/status Изменяет статус/этап lead Авторизованный пользователь

GET /v1/tasks Выводит список задач Авторизованный пользователь

POST /v1/tasks Создаёт задачу Авторизованный пользователь

GET /v1/messages Выводит список сообщений коммуникации с пациентом Авторизованный пользователь

POST /v1/messages Создаёт запись сообщения/коммуникации Авторизованный пользователь

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

Обновить статус lead

Запрос

curl -X POST https://api.udentiva.com/v1/leads/{id}/status \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"status":"qualified"}'

Ответ

HTTP/1.1 200 OK
{
  "id": "ld-88",
  "status": "qualified"
}

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

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

Записи lead и коммуникации изолированы в вашей клинике (RLS).

Публичный приём lead (landing) — это отдельный, бессессионный endpoint с ограничением скорости; спам предотвращается оконным лимитом Redis.

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

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

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

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

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

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

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

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

Связаться