Извлечение реквизитов из карточки компании и документов для 1С через АПИ

🔹 Введение

🔹 Возможности API

🔹 Технические параметры эндпоинта

Заголовки запроса

Тело запроса

🟦 1С:Предприятие 8 (управляемые формы)

Процедура ОтправитьФайлНаСервере()
    // 1. Проверка - выбран ли файл
    Если ПустаяСтрока(ЭтотОбъект.ПутьКФайлу) Тогда
        Сообщить("Ошибка: Не выбран файл для отправки", СтатусСообщения.Важное);
        Возврат;
    КонецЕсли;
    
    // 2. Проверка наличия API-ключа
    Если ПустаяСтрока(ЭтотОбъект.APIКлюч) Тогда
        Сообщить("Ошибка: Не указан API-ключ", СтатусСообщения.Важное);
        Возврат;
    КонецЕсли;   
    
    // 3. Проверка существования файла
    ФайлДляПроверки = Новый Файл(ЭтотОбъект.ПутьКФайлу);
    Если Не ФайлДляПроверки.Существует() Тогда
        Сообщить("Ошибка: Файл не найден по пути " + ЭтотОбъект.ПутьКФайлу, СтатусСообщения.Важное);
        Возврат;
    КонецЕсли;
    
    // 4. Чтение файла в двоичные данные
    ДвоичныеДанныеФайла = Новый ДвоичныеДанные(ЭтотОбъект.ПутьКФайлу);
    ИмяФайла = ФайлДляПроверки.Имя;
    
	// 5. Формирование тела запроса (multipart/form-data) — ИСПРАВЛЕННЫЙ вариант
	Граница = "----WebKitFormBoundary" + СтрЗаменить(Строка(Новый УникальныйИдентификатор()), "-", "");

	Тело = Новый ПотокВПамяти;
	ЗаписьДанных = Новый ЗаписьДанных(Тело, , , Символы.ВК + Символы.ПС, "");  // Ключ: CRLF и пустой РазделительСтрок

	ЗаписьДанных.ЗаписатьСтроку("--" + Граница);
	ЗаписьДанных.ЗаписатьСтроку("Content-Disposition: form-data; name=""file""; filename=""" + ИмяФайла + """");
	ЗаписьДанных.ЗаписатьСтроку("Content-Type: application/octet-stream");
	ЗаписьДанных.ЗаписатьСтроку("");  // Пустая строка перед данными
	ЗаписьДанных.Записать(ДвоичныеДанныеФайла);  // Двоичные данные файла
	ЗаписьДанных.ЗаписатьСтроку("");  // Пустая строка после данных
	ЗаписьДанных.ЗаписатьСтроку("--" + Граница + "--");  // Закрывающий разделитель

	ЗаписьДанных.Закрыть();
	ДвоичныеДанныеТела = Тело.ЗакрытьИПолучитьДвоичныеДанные();    
    // 6. Формирование HTTP-запроса
    ИмяСервера = "api-k.ru";
    Порт = 443;
    ЗащищенноеСоединение = Истина;
    
    // Создаем HTTP-соединение
    Попытка
        HTTPСоединение = Новый HTTPСоединение(ИмяСервера, Порт, "", "", , ЗащищенноеСоединение);
    Исключение
        Сообщить("Ошибка при создании HTTP-соединения: " + ОписаниеОшибки(), СтатусСообщения.Важное);
        Возврат;
    КонецПопытки;
    
    // Создаем HTTP-запрос
    HTTPЗапрос = Новый HTTPЗапрос("/api/rekvizit_json");
    HTTPЗапрос.Заголовки.Вставить("X-API-Key", ЭтотОбъект.APIКлюч);
    HTTPЗапрос.Заголовки.Вставить("Content-Type", "multipart/form-data; boundary=" + Граница);  
    HTTPЗапрос.УстановитьТелоИзДвоичныхДанных(ДвоичныеДанныеТела); 
	HTTPЗапрос.Заголовки.Вставить("Content-Length", XMLСтрока(ДвоичныеДанныеТела.Размер())); 
    
    // Отправляем запрос
    Попытка
        Ответ = HTTPСоединение.ВызватьHTTPМетод("POST", HTTPЗапрос);
        
        Если Ответ.КодСостояния = 200 Тогда
            СтрокаОтвета = Ответ.ПолучитьТелоКакСтроку();
            РазобратьИОтобразитьРезультат(СтрокаОтвета);
            ЭтотОбъект.ОтветСервера = СтрокаОтвета;
            Сообщить("Успешно! Файл обработан, реквизиты получены.", СтатусСообщения.Информация);
        Иначе
            СтрокаОшибки = Ответ.ПолучитьТелоКакСтроку();
            ЭтотОбъект.ОтветСервера = СтрокаОшибки;
            Сообщить("Ошибка HTTP " + Строка(Ответ.КодСостояния) + ": " + СтрокаОшибки, СтатусСообщения.Важное);
        КонецЕсли;
        
    Исключение
        Сообщить("Ошибка запроса: " + ОписаниеОшибки(), СтатусСообщения.Важное);
    КонецПопытки;   
КонецПроцедуры

Структура ответа API

Успешный ответ (HTTP 200)

{
  "data": {
    "organization_name": "ООО «Пример»",
    "inn": "7701234567",
    "kpp": "770101001",
    "ogrn": "1027700123456",
    "address": "109457, г. Москва, ул. Привольная, д. 61, кв. 1",
    "phone": "+7(899) 456-23-33",
    "bank_name": "ПАО Сбербанк",
    "bik": "044525225",
    "checking_account": "40702810123456789012",
    "correspondent_account": "30101810400000000225",
    "type_doc": "акт",
    "nom_doc": "1",
    "signatory": "Иванова Н.В."
  },
  "file_size": 20480,
  "filename": "2.doc",
  "success": true
}

Ответ с ошибкой

{
  "success": false,
  "error": "invalid_request",
  "message": "Отсутствует тело запроса"
}

📋 Описание полей ответа

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

🔹 Рекомендации по интеграции в 1С

1. Таймаут: всегда устанавливайте 120 секунд, особенно для PDF с большим объёмом текста.
2. Форматы файлов: для PDF убедитесь, что документ содержит текстовый слой (не скан-изображение).
3. Валидация: проверяйте поле success перед использованием данных.
4. Логирование: сохраняйте ответы API для отладки и аудита.
5. Безопасность: храните X-API-Key в защищённом хранилище, не в коде.