Перейти к основному содержанию
Используй это руководство, чтобы найти локацию для сдачи анализов, создать запись для профиля пациента и прикрепить нужные панели анализов. Выполни эти шаги до того, как пациент придёт на забор крови.
1

Посмотри доступные локации

Получи список локаций для сдачи анализов, доступных твоему аккаунту, отправив запрос GET на /api/v1/locations.
В ответе вернётся массив объектов локаций:
Используй поле timezone из объекта локации, когда формируешь метку времени scheduled_at. Перевод времени записи в местный часовой пояс локации поможет не назначить её вне часов работы.
Не определяй доступное для записи время только по open_hours. Вызови Получение доступных слотов и бронируй начало одного из возвращённых слотов — эта сетка также учитывает существующие записи, исключения по датам и минимальный срок до записи.
2

Создай запись

Отправь запрос POST на /api/v1/appointments с ID профиля, ID локации и желаемым временем записи. Время должно совпадать с началом слота из Получения доступных слотов.
Значение scheduled_at должно быть датой и временем в будущем в формате ISO 8601, например 2026-05-12T07:30:00Z. Метки времени в прошлом отклоняются с ошибкой 400, как и время в пределах 12-часового минимального срока до записи в локациях под управлением Aniva.
Повторять этот запрос безопасно. У профиля может быть только одна запись на конкретную локацию и время, поэтому повторный или продублированный запрос вернёт 409 с существующим appointment_id вместо двойной записи пациента.
Успешный запрос возвращает 201 Created с объектом записи:
Сохрани id записи — он понадобится тебе, чтобы добавить панели и подтвердить забор крови.
3

Добавь панели анализов

Прикрепи панели анализов, которые нужно выполнить для образца крови, отправив запрос POST на /api/v1/appointments/{id}/panels.ID панелей — это UUID. Вызови Список панелей, чтобы получить панели, которые может заказывать твой API-ключ.
После подтверждения забора крови добавлять панели нельзя. Добавь все нужные панели до подтверждения — подробности см. в Подтверждении забора крови.
Успешный запрос возвращает 200 OK с подтверждением, что панели добавлены:

Перенос или отмена

После создания запись ещё можно изменить до подтверждения забора крови:
  • Перенести или сменить локацию — отправь запрос PATCH на /api/v1/appointments/{id} с полями для обновления. См. Обновление записи.
  • Отменить — отправь запрос DELETE на /api/v1/appointments/{id}. См. Отмена записи.
Обе операции доступны только до забора крови — то есть пока запись находится в статусе pending или confirmed. Как только запись переходит в статус blood_drawn, внести изменения уже нельзя.

Обработка ошибок