API UzmiTermin отдаёт записи вашей компании на ваш сервер в формате JSON: дату и время, статус, мастера, услуги, имя и телефон клиента. Так можно показать ближайшие визиты в личном кабинете на сайте, выгрузить записи в таблицу или передать их в CRM. API только для чтения. В этом руководстве вы создадите ключ, отправите первый запрос и разберёте ответ.
Войдите в аккаунт компании и откройте раздел API-ключи на этой странице.
Создайте ключ и дайте ему понятное название, например «Сайт».
Сразу скопируйте ключ и сохраните его в настройках сервера - например, в переменной окружения 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 | Слишком много запросов |