API UzmiTermin отдаёт записи вашей компании на ваш сервер в формате JSON: дату и время, статус, мастера, услуги, имя и телефон клиента. Так можно показать ближайшие визиты в личном кабинете на сайте, выгрузить записи в таблицу или передать их в CRM. API только для чтения. В этом руководстве вы создадите ключ, отправите первый запрос и разберёте ответ.

Перед началом

Создайте ключ

  1. Войдите в аккаунт компании и откройте раздел API-ключи на этой странице.

  2. Создайте ключ и дайте ему понятное название, например «Сайт».

  3. Сразу скопируйте ключ и сохраните его в настройках сервера - например, в переменной окружения UZMI_API_KEY. Ключ показывается только один раз: мы храним лишь его отпечаток, поэтому потерянный ключ не восстановить, только заменить новым.

Если ключ мог попасть в чужие руки, отзовите его: он перестанет работать сразу.

Получить API ключ

Отправьте первый запрос

Передайте ключ в заголовке Authorization и запросите записи за неделю:

curl "https://public-api.uzmitermin.rs/v1/appointments?from=2026-10-19&to=2026-10-25" \
  -H "Authorization: Bearer $UZMI_API_KEY"

В ответ придёт массив записей, отсортированный по дате и времени начала:

[
  {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "date": "2026-10-23",
    "startTime": "10:00",
    "endTime": "11:00",
    "status": "CONFIRMED",
    "master": { "id": "1b4e28ba-2fa1-41d2-883f-0016d3cca427", "name": "Ирина" },
    "services": [{ "id": "6fa459ea-ee8a-4ca4-894e-db77e160355e", "name": "Стрижка", "duration": 60 }],
    "client": { "name": "Анна", "phone": "+381601234567" },
    "comment": null,
    "createdAt": "2026-10-20T12:00:00.000Z",
    "updatedAt": "2026-10-21T09:30:00.000Z"
  }
]

Получите записи за период

Период задаётся параметрами from и to - даты в формате YYYY-MM-DD, обе включительно, период не длиннее 31 дня. Записи приходят все сразу, без постраничной выдачи.

ПараметрОбязательныйЧто задаёт
fromДаПервый день периода
toДаПоследний день периода, не дальше 31 дня от from
masterIdНетТолько записи одного мастера
statusНетТолько записи с этими статусами, через запятую: CONFIRMED,MASTER_CONFIRMATION

Тот же запрос из кода сайта:

PHP

<?php
$url = 'https://public-api.uzmitermin.rs/v1/appointments?' . http_build_query([
    'from' => '2026-10-19',
    'to' => '2026-10-25',
    'status' => 'CONFIRMED',
]);

$response = file_get_contents($url, false, stream_context_create([
    'http' => ['header' => 'Authorization: Bearer ' . getenv('UZMI_API_KEY')],
]));

$appointments = json_decode($response, true);

Node.js

const params = new URLSearchParams({ from: '2026-10-19', to: '2026-10-25', status: 'CONFIRMED' });

const response = await fetch(`https://public-api.uzmitermin.rs/v1/appointments?${params}`, {
    headers: { Authorization: `Bearer ${process.env.UZMI_API_KEY}` },
});

const appointments = await response.json();

Одну запись можно получить по идентификатору: GET /v1/appointments/{id}.

Разберите ответ

ПолеЧто содержит
date, startTime, endTimeДата и время визита по часовому поясу салона
statusСтатус записи, см. ниже
masterМастер: id и name. null, если мастер не выбран
servicesУслуги: id, name и длительность duration в минутах
clientКлиент: name и phone
commentКомментарий к записи или null
createdAt, updatedAtКогда запись создана и когда менялась в последний раз
СтатусЗначение
ACTIVEЗаписано
MASTER_CONFIRMATIONЖдёт подтверждения мастера
USER_CONFIRMATIONЖдёт, пока клиент подтвердит новое время
CONFIRMEDПодтверждено
REJECTEDМастер отклонил, или клиент сказал, что запись не его
CANCELEDОтменено

Чтобы найти, что изменилось с прошлой выгрузки, сравните updatedAt записи с временем той выгрузки.

Обработайте ошибки и лимиты

На один ключ - 60 запросов в минуту. Сколько осталось, показывают заголовки ответа X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset.

КодКогда
400Неверные даты, to раньше from, период длиннее 31 дня или неизвестный статус
401Нет ключа, ключ неверный или отозван
403У компании нет активной подписки
404Такой записи нет в вашей компании
429Слишком много запросов

Что дальше