API 1С

// Пример запроса GET https://cert4u.ru/api.php?action=api_1c_documents&api_key=ВАШ_КЛЮЧ

{ "success": false, "message": "Описание ошибки" }

// Общая функция для GET-запросов к API Функция ВыполнитьЗапросAPI(Действие, Параметры = "") АдресСервера = "cert4u.ru"; КлючAPI = "ВАШ_API_КЛЮЧ"; // Из настроек URL = "/cert/api.php?action=" + Действие + "&api_key=" + КлючAPI; Если ЗначениеЗаполнено(Параметры) Тогда URL = URL + "&" + Параметры; КонецЕсли; SSL = Новый ЗащищенноеСоединениеOpenSSL(); Соединение = Новый HTTPСоединение(АдресСервера, 443, , , , , SSL); Запрос = Новый HTTPЗапрос(URL); Ответ = Соединение.Получить(Запрос); Если Ответ.КодСостояния = 200 Тогда ЧтениеJSON = Новый ЧтениеJSON; ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку("UTF-8")); Результат = ПрочитатьJSON(ЧтениеJSON); ЧтениеJSON.Закрыть(); Возврат Результат; Иначе ВызватьИсключение "Ошибка API: " + Ответ.КодСостояния; КонецЕсли; КонецФункции

// POST-запрос с JSON-телом Функция ВыполнитьPOSTЗапросAPI(Действие, ДанныеJSON) АдресСервера = "cert4u.ru"; КлючAPI = "ВАШ_API_КЛЮЧ"; URL = "/cert/api.php?action=" + Действие + "&api_key=" + КлючAPI; SSL = Новый ЗащищенноеСоединениеOpenSSL(); Соединение = Новый HTTPСоединение(АдресСервера, 443, , , , , SSL); Запрос = Новый HTTPЗапрос(URL); Запрос.Заголовки.Вставить("Content-Type", "application/json"); // Формируем JSON ЗаписьJSON = Новый ЗаписьJSON; ЗаписьJSON.УстановитьСтроку(); ЗаписатьJSON(ЗаписьJSON, ДанныеJSON); ТелоJSON = ЗаписьJSON.Закрыть(); Запрос.УстановитьТелоИзСтроки(ТелоJSON, "UTF-8"); Ответ = Соединение.ОтправитьДляОбработки(Запрос); ЧтениеJSON = Новый ЧтениеJSON; ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку("UTF-8")); Результат = ПрочитатьJSON(ЧтениеJSON); ЧтениеJSON.Закрыть(); Возврат Результат; КонецФункции

// Загрузка документа через multipart/form-data Функция ЗагрузитьДокумент(ПутьКФайлу, НазваниеДокумента, IDКлиента = "") АдресСервера = "cert4u.ru"; КлючAPI = "ВАШ_API_КЛЮЧ"; URL = "/cert/api.php?action=api_1c_upload&api_key=" + КлючAPI; SSL = Новый ЗащищенноеСоединениеOpenSSL(); Соединение = Новый HTTPСоединение(АдресСервера, 443, , , , , SSL); Запрос = Новый HTTPЗапрос(URL); Граница = "----Boundary" + Строка(Новый УникальныйИдентификатор); Запрос.Заголовки.Вставить("Content-Type", "multipart/form-data; boundary=" + Граница); // Читаем файл ДД = Новый ДвоичныеДанные(ПутьКФайлу); ИмяФайла = Сред(ПутьКФайлу, СтрДлина(ПутьКФайлу) - СтрНайти(ПутьКФайлу, "\") + 2); // Собираем multipart body Тело = "--" + Граница + Символы.ПС; Тело = Тело + "Content-Disposition: form-data; name=""doc_name""" + Символы.ПС + Символы.ПС; Тело = Тело + НазваниеДокумента + Символы.ПС; Если ЗначениеЗаполнено(IDКлиента) Тогда Тело = Тело + "--" + Граница + Символы.ПС; Тело = Тело + "Content-Disposition: form-data; name=""client_id""" + Символы.ПС + Символы.ПС; Тело = Тело + IDКлиента + Символы.ПС; КонецЕсли; Тело = Тело + "--" + Граница + Символы.ПС; Тело = Тело + "Content-Disposition: form-data; name=""document""; filename=""" + ИмяФайла + """" + Символы.ПС; Тело = Тело + "Content-Type: application/pdf" + Символы.ПС + Символы.ПС; // Записываем через поток Поток = Новый ПотокВПамяти; ЗаписьТекста = Новый ЗаписьДанных(Поток); ЗаписьТекста.ЗаписатьСтроку(Тело, "UTF-8"); ЗаписьТекста.Записать(ДД); ЗаписьТекста.ЗаписатьСтроку(Символы.ПС + "--" + Граница + "--" + Символы.ПС, "UTF-8"); ЗаписьТекста.Закрыть(); Запрос.УстановитьТелоИзДвоичныхДанных(Поток.ЗакрытьИПолучитьДвоичныеДанные()); Ответ = Соединение.ОтправитьДляОбработки(Запрос); ЧтениеJSON = Новый ЧтениеJSON; ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку("UTF-8")); Результат = ПрочитатьJSON(ЧтениеJSON); ЧтениеJSON.Закрыть(); Возврат Результат; КонецФункции

// Полный цикл подписания документа Процедура ОтправитьДокументНаПодпись(ПутьКФайлу, НазваниеДокумента, IDКлиента) // 1. Загрузить документ РезультатЗагрузки = ЗагрузитьДокумент(ПутьКФайлу, НазваниеДокумента, IDКлиента); Если НЕ РезультатЗагрузки.success Тогда Сообщить("Ошибка загрузки: " + РезультатЗагрузки.message); Возврат; КонецЕсли; IDДокумента = РезультатЗагрузки.document.id; Сообщить("Документ загружен: " + IDДокумента); // 2. Подписать администратором ДанныеПодписи = Новый Структура("doc_id", IDДокумента); РезультатПодписи = ВыполнитьPOSTЗапросAPI("api_1c_sign_admin", ДанныеПодписи); Если НЕ РезультатПодписи.success Тогда Сообщить("Ошибка подписания: " + РезультатПодписи.message); Возврат; КонецЕсли; Сообщить("Документ подписан администратором"); // 3. Отправить клиенту ДанныеОтправки = Новый Структура; ДанныеОтправки.Вставить("doc_id", IDДокумента); ДанныеОтправки.Вставить("sign_type", "ukep_only"); // или "pep_only" РезультатОтправки = ВыполнитьPOSTЗапросAPI("api_1c_send", ДанныеОтправки); Если РезультатОтправки.success Тогда Сообщить("Отправлено! Ссылка: " + РезультатОтправки.sign_url); КонецЕсли; КонецПроцедуры

// Проверить подписи и получить данные сертификата Функция ПроверитьПодпись(IDДокумента) Результат = ВыполнитьЗапросAPI("api_1c_verify", "id=" + IDДокумента); Если Результат.success Тогда // Данные подписи клиента ПодписьКлиента = Результат.client_signature; Если ПодписьКлиента.valid Тогда Сообщить("Подпись клиента: ВЕРНА"); Сообщить("Тип: " + ПодписьКлиента.type); // Данные из сертификата УКЭП Если ПодписьКлиента.Свойство("stored_cert_info") Тогда Серт = ПодписьКлиента.stored_cert_info; Сообщить("ФИО: " + Серт.subject_cn); Сообщить("ИНН: " + Серт.subject_inn); Сообщить("СНИЛС: " + Серт.subject_snils); Сообщить("ОГРН: " + Серт.subject_ogrn); Сообщить("Орг.: " + Серт.subject_org); Сообщить("УЦ: " + Серт.issuer_cn); КонецЕсли; Иначе Сообщить("Подпись клиента: НЕ ВЕРНА"); КонецЕсли; КонецЕсли; Возврат Результат; КонецФункции

// Скачать подписанный комплект документов Процедура СкачатьАрхив(IDДокумента, ПутьСохранения) АдресСервера = "cert4u.ru"; КлючAPI = "ВАШ_API_КЛЮЧ"; URL = "/cert/api.php?action=api_1c_download_zip&id=" + IDДокумента + "&api_key=" + КлючAPI; SSL = Новый ЗащищенноеСоединениеOpenSSL(); Соединение = Новый HTTPСоединение(АдресСервера, 443, , , , , SSL); Запрос = Новый HTTPЗапрос(URL); Ответ = Соединение.Получить(Запрос); Если Ответ.КодСостояния = 200 Тогда Ответ.ПолучитьТелоКакДвоичныеДанные().Записать(ПутьСохранения); Сообщить("Архив сохранён: " + ПутьСохранения); Иначе Сообщить("Ошибка скачивания: HTTP " + Ответ.КодСостояния); КонецЕсли; КонецПроцедуры

// ПЭП за один запрос: загрузка + подпись + отправка Функция БыстраяОтправкаПЭП(ПутьКФайлу, НазваниеДокумента, IDКлиента) АдресСервера = "cert4u.ru"; КлючAPI = "ВАШ_API_КЛЮЧ"; URL = "/cert/api.php?action=api_1c_pep_send&api_key=" + КлючAPI; // Аналогично ЗагрузитьДокумент(), но с action=api_1c_pep_send // Добавляем client_id в multipart form // ... (код multipart как в ЗагрузитьДокумент) // Результат содержит sign_url и pep_code Возврат Результат; КонецФункции

// Отправить один документ нескольким клиентам Процедура МассоваяОтправкаПЭП(IDДокумента, МассивIDКлиентов) Данные = Новый Структура; Данные.Вставить("doc_id", IDДокумента); Данные.Вставить("client_ids", МассивIDКлиентов); Результат = ВыполнитьPOSTЗапросAPI("api_1c_pep_bulk", Данные); Если Результат.success Тогда Для Каждого Элемент Из Результат.results Цикл Сообщить(Элемент.client_name + ": " + Элемент.sign_url); КонецЦикла; КонецЕсли; КонецПроцедуры