// Пример интеграции с API предварительной записи. // Платформа: 1С:Предприятие 8.3. // // Все функции используют HTTPS через ЗащищенноеСоединениеOpenSSL. // Для HTTP (не рекомендуется) замените СоздатьСоединение() на: // Возврат Новый HTTPСоединение(Сервер, Порт, , , , 30); // // В примере используется "timira.ru" — основной домен. Каждый клиент должен // передать свой внешний домен или IP, где развёрнута его копия системы // (путь /api/queue/booking не меняется). // // Параметры: // Сервер — "timira.ru" (без схемы; замените на адрес своей установки) // Порт — 443 // APIКлюч — "qk_test_sandbox_6b1f0c9d8e7a5b4c3d2e1f0a9b8c7d6e" // (тестовый ключ песочницы; для боевой работы — live-ключ // из админки «API-ключи», храните в секрете) // // Песочница: // qk_test_sandbox_6b1f0c9d8e7a5b4c3d2e1f0a9b8c7d6e // Брони тестового ключа не попадают в живую очередь. Функция СоздатьСоединение(Сервер, Порт) Экспорт Защищённое = Новый ЗащищенноеСоединениеOpenSSL(Неопределено, Неопределено); Возврат Новый HTTPСоединение(Сервер, Порт, , , , 30, Защищённое); КонецФункции Функция ЗаголовкиЗапроса(APIКлюч, ЕстьТело = Ложь) Экспорт Заголовки = Новый Соответствие; Заголовки.Вставить("X-API-Key", APIКлюч); Если ЕстьТело Тогда Заголовки.Вставить("Content-Type", "application/json"); КонецЕсли; Возврат Заголовки; КонецФункции Функция СериализоватьJSON(Значение) Экспорт ЗаписьJSON = Новый ЗаписьJSON; ПараметрыЗаписи = Новый ПараметрыЗаписиJSON(ПереносСтрокJSON.Авто, , Ложь); ЗаписьJSON.УстановитьСтроку(ПараметрыЗаписи); ЗаписатьJSON(ЗаписьJSON, Значение); Возврат ЗаписьJSON.Закрыть(); КонецФункции // Возвращает Структуру (не Соответствие): второй параметр ПрочитатьJSON = Ложь. Функция РазобратьJSON(ТелоОтвета) Экспорт ЧтениеJSON = Новый ЧтениеJSON; ЧтениеJSON.УстановитьСтроку(ТелоОтвета); Возврат ПрочитатьJSON(ЧтениеJSON, Ложь); КонецФункции Функция ВыполнитьЗапрос(Сервер, Порт, APIКлюч, Метод, Ресурс, ТелоЗапроса = Неопределено) Экспорт Соединение = СоздатьСоединение(Сервер, Порт); Заголовки = ЗаголовкиЗапроса(APIКлюч, ТелоЗапроса <> Неопределено); Запрос = Новый HTTPЗапрос(Ресурс, Заголовки); Если ТелоЗапроса <> Неопределено Тогда Запрос.УстановитьТелоИзСтроки(ТелоЗапроса); КонецЕсли; Ответ = Соединение.ВызватьHTTPМетод(Метод, Запрос); КодОтвета = Ответ.КодСостояния; ТелоОтвета = Ответ.ПолучитьТелоКакСтроку(); Если КодОтвета < 200 Или КодОтвета >= 300 Тогда ВызватьИсключение "Очередь: HTTP " + КодОтвета + ": " + ТелоОтвета; КонецЕсли; Возврат РазобратьJSON(ТелоОтвета); КонецФункции // POST /api/queue/booking Функция СоздатьЗаписьОчереди(Сервер, Порт, APIКлюч, ИдУслуги, ВремяЗаписи, ФИО, Телефон, Почта = "", Комментарий = "") Экспорт Тело = Новый Структура; Тело.Вставить("service_id", ИдУслуги); Тело.Вставить("scheduled_at", ВремяЗаписи); Тело.Вставить("customer", Новый Структура("name, phone, email", ФИО, Телефон, Почта)); Тело.Вставить("note", Комментарий); Идемпотентность = Строка(Новый УникальныйИдентификатор); Заголовки = ЗаголовкиЗапроса(APIКлюч, Истина); Заголовки.Вставить("Idempotency-Key", Идемпотентность); Соединение = СоздатьСоединение(Сервер, Порт); Запрос = Новый HTTPЗапрос("/api/queue/booking", Заголовки); Запрос.УстановитьТелоИзСтроки(СериализоватьJSON(Тело)); Ответ = Соединение.ВызватьHTTPМетод("POST", Запрос); КодОтвета = Ответ.КодСостояния; ТелоОтвета = Ответ.ПолучитьТелоКакСтроку(); Если КодОтвета <> 201 И КодОтвета <> 200 Тогда ВызватьИсключение "Очередь: ошибка API (" + КодОтвета + "): " + ТелоОтвета; КонецЕсли; Возврат РазобратьJSON(ТелоОтвета); КонецФункции // GET /api/queue/booking/slots?service_id=3&date=2026-12-01 Функция ПолучитьСлоты(Сервер, Порт, APIКлюч, ИдУслуги, Дата) Экспорт Если ТипЗнч(Дата) = Тип("Дата") Тогда ДатаСтрокой = Формат(Дата, "ДФ=yyyy-MM-dd"); Иначе ДатаСтрокой = Строка(Дата); КонецЕсли; Ресурс = "/api/queue/booking/slots?service_id=" + ИдУслуги + "&date=" + ДатаСтрокой; Возврат ВыполнитьЗапрос(Сервер, Порт, APIКлюч, "GET", Ресурс); КонецФункции // GET /api/queue/booking/services Функция ПолучитьУслуги(Сервер, Порт, APIКлюч) Экспорт Возврат ВыполнитьЗапрос(Сервер, Порт, APIКлюч, "GET", "/api/queue/booking/services"); КонецФункции // GET /api/queue/booking/schedule Функция ПолучитьПравилаЗаписи(Сервер, Порт, APIКлюч) Экспорт Возврат ВыполнитьЗапрос(Сервер, Порт, APIКлюч, "GET", "/api/queue/booking/schedule"); КонецФункции // GET /api/queue/booking/{booking_ref} Функция ПолучитьЗапись(Сервер, Порт, APIКлюч, КодЗаписи) Экспорт Возврат ВыполнитьЗапрос(Сервер, Порт, APIКлюч, "GET", "/api/queue/booking/" + КодЗаписи); КонецФункции // GET /api/queue/booking?date=2026-12-01&status=all Функция ПолучитьЗаписи(Сервер, Порт, APIКлюч, Дата, Статус = "booked", Страница = 1, Лимит = 50) Экспорт Если ТипЗнч(Дата) = Тип("Дата") Тогда ДатаСтрокой = Формат(Дата, "ДФ=yyyy-MM-dd"); Иначе ДатаСтрокой = Строка(Дата); КонецЕсли; Ресурс = "/api/queue/booking?date=" + ДатаСтрокой + "&status=" + Статус + "&page=" + Страница + "&limit=" + Лимит; Возврат ВыполнитьЗапрос(Сервер, Порт, APIКлюч, "GET", Ресурс); КонецФункции // POST /api/queue/booking/{booking_ref}/cancel Функция ОтменитьЗапись(Сервер, Порт, APIКлюч, КодЗаписи, Причина = "") Экспорт Тело = Новый Структура("reason", Причина); Ресурс = "/api/queue/booking/" + КодЗаписи + "/cancel"; Возврат ВыполнитьЗапрос(Сервер, Порт, APIКлюч, "POST", Ресурс, СериализоватьJSON(Тело)); КонецФункции // POST /api/queue/booking/{booking_ref}/reschedule Функция ПеренестиЗапись(Сервер, Порт, APIКлюч, КодЗаписи, НовоеВремя) Экспорт Тело = Новый Структура("scheduled_at", НовоеВремя); Ресурс = "/api/queue/booking/" + КодЗаписи + "/reschedule"; Возврат ВыполнитьЗапрос(Сервер, Порт, APIКлюч, "POST", Ресурс, СериализоватьJSON(Тело)); КонецФункции // ───────────────────────────────────────────────────────────────────────────── // Пример использования: // // Результат = СоздатьЗаписьОчереди( // "timira.ru", 443, "qk_test_sandbox_6b1f0c9d8e7a5b4c3d2e1f0a9b8c7d6e", // 3, "2026-12-01T14:30:00+03:00", // "Иван", "+79990000000", "i@example.ru", "Комментарий"); // Сообщить("Код записи: " + Результат.booking_ref); // Сообщить("Номер талона: " + Результат.number); // // Заметки: // • Для самоподписанного сертификата настройте доверие в ЗащищенноеСоединениеOpenSSL. // • Query-параметры с нестандартными значениями кодируйте КодироватьСтроку(...). // • Таймаут 30 с — сеть учреждения бывает медленной.