Выразительный Web API

Публикация № 1227351

Разработка - Системная интеграция - Интеграция с WEB

REST API HTTP-сервис Архитектура

Теория разработки Web API с ожидаемым поведением, за который не будет стыдно за пределами мира 1С.

Введение

Что такое API?

Термины URI, URL, URN

HTTP-протокол

HTTP-запрос

HTTP-ответ

Методы запросов

Идемпотентность?!

Версионирование

Best practices

REST

Примеры конкретных URI

Введение

В рамках публикации рассмотрим вопросы создания HTTP-сервиса согласно архитектурным принципам разработки Web API. Поведение сервиса должно быть детерминировано, прозрачно и предсказуемо. Для достижения этих целей используем архитектурный стиль REST. 

Что такое API?

Есть хороший пример идеального API не из мира IT и это ресторан. Если вы идете в ресторан как гость, то вам запрещено проходить на кухню. В этом случае вы должны знать, что вы можете заказать. Для этого у вас есть меню. После изучения меню, вы делаете заказ официанту, который передает заказ на кухню, и он же принесет вам то, что вы заказали. Официант может принести только то, что может дать ему кухня. Как же это относится к API? Официант это API ресторана. Вы пользователь API. Меню это документация, которая объясняет, что вы можете запросить у API. Блюдо в вашем заказе это запрос. Кухня это сервер, которая знает, как готовить то или иное блюдо.

Стоит заметить, что API это не только про Web. Например, все экспортные методы общего модуля или модуля менеджера документа - это тоже API.

Термины URI, URL, URN

  • URI - Uniform Resource Identifier (унифицированный идентификатор ресурса). Обозначает имя и адрес ресурса в сети. Как правило, делится на URL и URN.
  • URL - Uniform Resource Locator (унифицированный определитель местонахождения ресурса). Адрес некоторого ресурса в веб. URL определяет местонахождение ресурса и способ обращения к нему.
  • URN - Unifrorm Resource Name (унифицированное имя ресурса). Хороший пример это ISBN у книг (например, ISBN 978-5-699-12014-7 однозначно идентифицирует книгу, но ничего не говорит о ее местоположении). Смысл URN в том, что он определяет только название конкретного предмета, который может находится во множестве конкретных мест.

Можно сказать, что 

URI = URL + URN 

Приведу простой пример как это может выглядит на практике:

  • URI - https://mydomain.com/products.html
  • URL - https://mydomain.com
  • URN - /products.html

Еще пример структуры URI в виде картинки:

Протокол HTTP

HTTP - текстовый протокол передачи данных, который работает по схеме запрос-ответ (клиент-сервер). На данный момент является основным протоколом в Интернете. Поверх него часто делают прикладные протоколы (SOAP, WebDAV). Актуальная версия 1.1.

HTTP-запрос

Используется для отправки клиентом серверу запроса на получение информации. Формат запроса - текстовый.

Общий вид запроса

Метод Путь HTTP/Версия протокола

Host: Адрес

Другие заголовки (опционально)

(пустая строка)

Тело запроса (опционально)

Минимальный GET запрос

GET /wiki/HTTP HTTP/1.1

Host: ru.wikipedia.org

HTTP-ответ

Используется для отправки сервером клиенту запрошенных данных. Формат ответа - текстовый.

Общий вид ответа

HTTP/Версия протокола Код статуса/Текст статуса

Заголовки

(пустая строка)

Тело ответа (опционально)

Пример ответа сервера

HTTP/1.1 200 OK

Content-Type: text/html; charset=utf-8 Content-Length: 512

(пустая строка)

(тело ответа)

Методы запросов

Для каждого запроса обязательным является указание метода. Рассмотрим самые популярные методы в контексте CRUD операций. Если говорить о SQL, то вы не сможете оператором select удалить данные, а оператором update вставить новые. Что касается методов HTTP-запросов, то технически такого ограничения нет. Если вы разрабатываете веб-сервис, то можете сделать так, что любым методом можно получить данные или удалить. Но так делать крайне не рекомендуется, потому что это будет неожиданное поведение сервиса, да и в принципе для этих операций есть свои методы. 

Распространенные методы

  • GET - получение содержимого указанного ресурса (Retrieve в контексте CRUD).
  • POST - передача данных или для операции Create в контексте CRUD.
  • PUT - изменение данных ресурса целиком (операция Update в контексте CRUD).
  • DELETE - удаление указанного ресурса (Delete в контексте  CRUD).
  • PATCH - частичное изменение ресурса (применяется не часто, обычно используется PUT)
  • HEAD - практически тоже самое, что GET, но без тела ответа. Можно использовать как валидацию URL через кастомный заголовок в ответе.

Если веб сервис разрабатывается для работы с формами HTML, то можно использовать только методы GET, POST. Но для поддержки остальных достаточно использовать JS. Если говорить не про формы, то в любом современном ЯП есть поддержка остальных методов "из коробки".

Идемпотентность

Выдыхайте, это про методы запросов. Запрос является идемпотентным, если повторный идентичный запрос, сделанный с его помощью, гарантирует одинаковое воздействие на систему, при этом возвращаемые ответами коды статусов могут быть различными. Другими словами, идемпотентный метод не должен иметь никаких побочных эффектов (side-effects).

Идемпотентные методы

  • GET, HEAD - независимо от того, сколько будет раз запрошен ресурс, состояние системы никак не меняется.
  • PUT, PATH - состояние ресурса при идентичных запросах будет изменено только в первый раз (ресурс с id=0 имел имя name0, после первого изменения имя стало name1, но и при последующих запросах оно вновь будет name1).
  • DELETE - удалить ресурс с помощью идентичных запросов можно также только один раз.

Важно понимать, что ответ сервера при идемпотентных запросах может быть различным. Например, при попытке удалить ресурс, ответ на второй и последующие запросы может быть с информацией о том, что такого ресурса в принципе нет. При этом состояние системы никак не меняется. 

Не идемпотентные методы

  • POST - независимо от того, сколько раз мы передадим данные, они будут добавлены (не берем в расчет контроль уникальности реквизитов), то есть состояние системы меняется при каждом запросе.

Почему идемпотентность важна? Это соглашение. То есть это то, на что пользователи будут рассчитывать при работе с вашим сервером.

Версионирование

На практике приходилось несколько раз сталкиваться с ситуацией, когда разработчик API менял его, считая что он монополист и может делать с ним что угодно. По факту, даже если у вас есть хотя бы один пользователь, то необходимо использовать версионирование, так как клиентский код опирается на ваши методы. Сделать его несложно. Мне известно два способа:

  • URL - {host}/v1/products
  • Custom header - api-version:1

Best practices

Поделюсь списком лучших практик, которые использую в своей работе:

  • Никакой кириллицы при именовании ресурсов. Иначе адрес придется кодировать и при интеграции со сторонними системами никто вам спасибо за такое не скажет.
  • В модуле http-сервиса только логика работы с объектом HTTPRequest. Вся бизнес-логика должна быть вынесена в общий модуль. Так вы получите независимые слои приложения (с натяжкой сюда можно прикрутить термин MVC) и простоту тестирования бизнес-логики.
  • Методы POST и PUT должны отдавать соответственно созданный и измененный объекты обратно. Этим вы избавите клиента от повторного вызова вашего сервиса.
  • Поддержка обработки заголовка Content-Type. Например, если заголовок не указан - сервис отдает ответ в формате json, а если указан application/xml - то ответ в xml.
  • Стандартные коды статусов ответов. Например, код 415 используйте тогда, когда клиент запрашивает ответ в формате xml, а вы его не поддерживаете. В противном случае поведение придется описывать в документации.
  • Pretty print для сериализованных данных. Экономия на символах табуляции дает не так много, зато убивает читаемость ответа при отладке. 
  • Если на сервере опубликован не только ваш веб-сервис, а допустим веб-клиент, то необходимо разделение таких ресурсов через URI. Обычно, сервис начинается с /api/.... В нашем случае платформа за нас добавляет /hs. Так что этот пункт не обязателен, но помнить про него нужно. 

REST

REST (Representational State Transfer — «передача состояния представления»). Не является протоколом, но описывает набор архитектурных принципов формирования API.

Основные идеи REST

  • Клиент-серверная архитектура.
  • Все есть ресурс.
  • Любой ресурс имеет ID (путь из URI).
  • Сервер не хранит никакого состояния, то есть все обработчики stateless. Вся информация, которая необходима для обработки запроса, передается клиентом вместе с запросом.
  • Список доступных действий определяется стандартными методами HTTP.

В связи с недавней популярностью этой аббревиатуры, многие ее смысл понимали как что угодно, лишь бы это было связано с формированием Web API. На самом деле, это правила формирования URI. В качестве примера можно привести структуру папок на диске и доступные операции с ними. Допустим есть папка D:/files и есть файл Dummy.data. Если необходимо получить содержимое файла, то используется D:/files/dummy.data. Если нужно изменить файл, то опять же D:/files/dummy.data. Если нужны все файлы из это папки, то D:/files. При любой операции с файлами остается неизменным путь к папке. Именно такой подход используется в REST.

Но такой подход далеко не всегда удобен. Например, если вы пишете сервис для обмена с другой ИС на платформе 1С и в обоих случаях используются планы обмена, то REST здесь вряд ли подойдет, потому что клиент в теле запроса присылает целую пачку данных и скорей всего ваш сервис будет состоять из 1-2 методов. Ранее я освещал эту тему - Обмен без правил.

Примеры конкретных URI

Рассмотрим конкретный пример сервиса для работы с товарами.

Действие Метод URI
Получить список всех товаров GET /products
Получить список всех товаров марки NoName и классом продукта A  GET /products?brand=NoName&class=A
Получить определенный товар (id=0) GET /products/0
Добавить товар POST /products
Изменить товар PUT

/products/0

Удалить товар DELETE /products/0

 

Примеры неправильных URI

  • /products/getAll
  • /products/brand/NoName
  • /products/?action=put&id=0
  • /products/delete/?id=0
 
 Пример того, как такой сервис может выглядеть на уровне метаданных 1С

Специальные предложения

Комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
1. CyberCerber 624 27.04.20 17:34 Сейчас в теме
Полезная статья, спасибо!
Буквально месяц - два назад сам искал best practices, правила написания хорошего API.
Ты рассказал про общие методы: создание, изменение объекта...
А как правильно реализовать, например, поиск объектов по фильтрам? Это будет GET или POST? Что стоит делать параметрами url, а что помещать в тело запроса?
nekit_rdx; +1 Ответить
2. nbeliaev 27.04.20 17:43 Сейчас в теме
(1) Спасибо за отзыв )
В разделе Примеры конкретных URI есть инфо как реализовать поиск по фильтрам и как его не надо делать (если быть точным то вот это /products?brand=NoName&class=A).
3. CyberCerber 624 27.04.20 17:55 Сейчас в теме
(2) А если нужно передать фильтры по сложнее? Например, найти товары:
1. В списке категорий: Телефоны, Планшеты, Часы
2. Имя содержит "самое лучшее устройство *&^%$#* !"
3. Страна производства не равна Китай
4. nbeliaev 27.04.20 18:02 Сейчас в теме
(3) Я бы все делал через параметры запроса, они специально для этого и заточены. То есть так как это все же получение данных, то метод GET, а в нем тела нет. Другой вопрос, что может немного придется распарсить такие параметры уже на стороне сервера.
6. CyberCerber 624 27.04.20 22:06 Сейчас в теме
(4) В общем случае, фильтры могут быть представлены произвольным JSONом. Нормально передавать JSON параметром URLа?
7. nbeliaev 28.04.20 05:36 Сейчас в теме
(6) Скорей всего придется кодировать такую строку из за спец. символов в json. А нормально ли передавать или нет, точного ответа я не могу дать, не сталкивался ни разу. Но сам бы я подумал хорошо еще раз перед тем как использовать такой подход.
8. ltfriend 546 28.04.20 09:19 Сейчас в теме
(6) конечно, идеологически для возврата результатов поиска больше подходит GET. Вы данные получаете, а не добавляете, изменяете или удаляете. Но если вы используете сложные параметры (фильтры), то разумней сделать POST с JSON'ом в теле. Это не является криминалом. А общие рекомендации не являются обязательными к исполнению и вполне могут быть исключения. И не стоит забывать, что передавая кучу сложных параметров в URL вы можете превысить его максимально допустимую длину.
9. nbeliaev 28.04.20 09:23 Сейчас в теме
(8) Согласен, что это всего лишь рекомендации и про длину вы верно подметили. Все зависит от конкретного кейса. Поэтому я и написал, что надо подумать.
Но в общем случае все же GET предпочтительнее )
10. ltfriend 546 28.04.20 09:25 Сейчас в теме
(9) в общем случае конечно. Но бывают частные, в которых как раз и можно отойти от общих рекомендаций.
11. CyberCerber 624 28.04.20 09:57 Сейчас в теме
(8) Да, вот у меня поэтому и был вопрос, т.к. частенько я встречаю API, где получение данных проходит через POST, т.к. в теле передается полноценный JSON.
12. nomad_irk 49 28.04.20 10:07 Сейчас в теме
(11)ИМХО, тут работает такое же правило, как и везде: если параметров у процедуры/функции можно пересчитать по пальцам одной руки, то их МОЖНО запихать в строку запроса GET, если больше - делай полноценный POST с блэкджеком и прочей атрибуикой......
5. nicxxx 239 27.04.20 18:30 Сейчас в теме
(1) Посмотрите документацию по интерфейсу oData, который 1С предоставляет по-умолчанию. Там есть про фильтры.
13. bulpi 175 28.04.20 12:09 Сейчас в теме
Единственный ИМХО сомнительный совет в статье :
"Методы POST и PUT должны отдавать соответственно созданный и измененный объекты обратно."
А если он там на фиг не нужен, зачем его отдавать?
14. nbeliaev 28.04.20 12:26 Сейчас в теме
(13) Спасибо за проявленный интерес.
Отдавать нужно, чтобы клиент мог проверить какие-то ключевые поля (например те, которые считаются на сервере). То есть ему не нужно дергать сервис еще раз через GET чтобы получить созданные/обновленные атрибуты сущности.
16. malikov_pro 514 29.04.20 05:52 Сейчас в теме
(14) Зависит от варианта использования, если данные записаны некорректно, то это ошибка сервиса, о которой нужно сообщить клиенту.

У Вас указана структура метаданных, но она неудобна для обработки листенерами (предварительные проверки и аутентификация), мои наработки по теме https://infostart.ru/public/1131305/, буду рад разумной критике.

В статью можно добавить вариант обработки 404, потому что при if GET/{id} -> 404(POST) else (PUT/{id}) насоздавать дубликатов, а 404 может выдать и прокси. Вариант решения договоренность через документацию о формате тела ответа при ошибке.

С вопросом практики реализации имеет смысл связать вопрос документирования.
17. nbeliaev 29.04.20 07:33 Сейчас в теме
(16) Спасибо за комментарий.

аутентификация
- у нас есть Basic auth. Если этого не достаточно, то можно использовать токены в заголовках.

предварительные проверки
- про что именно вы говорите? Валидация запроса? Если да, то не упомянул этот момент в публкации, может есть смысл добавить.

404
- конечно нужно это делать и не только 404. В целом я упомянул про коды статусов, но расписывать не стал, так как нужен более конкретный пример для этого.
18. malikov_pro 514 29.04.20 07:57 Сейчас в теме
(17)
"Basic auth" реализованная на уровне платформы привязана к пользователям в конфигураторе это не всегда удобно, как и подсистема БСП внешних пользователей.
В своих проектах использую справочник внешних пользователей и листенером для всех запросов делаю проверку.

"Валидация запроса?" - в общем да, проще проверить перед тем как отправлять данные в общий модуль (контроллер по сути).


"более конкретный пример для этого." - пример типа ресурса(формат RAML) во вложении, в основном блоке используется:
/categories:
  type: collection-item
  description: Работа со справочником категории (группы номенклатуры в 1С)
  /{xml_id}:
      type: item


Можно совместно продумать и сделать описание/реализацию основных функций по работе с объектами для 1С, аналог https://infostart.ru/public/709325/ только для сервера.
Прикрепленные файлы:
item.type.raml
15. hardcodder2020 28.04.20 13:11 Сейчас в теме
Статья полезная, спасибо, автор!
19. Vortigaunt 82 03.05.20 18:16 Сейчас в теме
В модуле http-сервиса только логика работы с объектом HTTPRequest. Вся бизнес-логика должна быть вынесена в общий модуль. Так вы получите независимые слои приложения (с натяжкой сюда можно прикрутить термин MVC) и простоту тестирования бизнес-логики.

Эта рекомендация важна не только ради красоты. Как оказалось, 1С не проверяет синтаксис в модуле http-сервиса. И чем меньше там будет кода, тем меньше нервов потратишь при отладке.
20. Cyberhawk 122 10.06.20 09:06 Сейчас в теме
Хорошо бы для каждого примера из раздела
Примеры неправильных URI
дать пояснение, что и почему там неправильно
21. nbeliaev 10.06.20 13:14 Сейчас в теме
(20)
Спасибо за интерес к материалу.
/products/getAll - REST оперирует глаголами, которые предоставляют методы HTTP. Здесь мы изобрели "свой" глагол
/products/brand/NoName - Попробуйте представить что будет, если кроме brand будет еще хотя бы 5 параметров. Для этого есть параметры запроса, а не части пути.
/products/?action=put&id=0 - Практически аналогично с первым пунктом, только здесь глагол как параметр запроса.
/products/delete/?id=0 - Практически аналогично с первым пунктом, только здесь глагол как часть пути.
22. Cyberhawk 122 10.06.20 13:24 Сейчас в теме
(21) Я не для себя спрашивал :)
Неплохо бы добавить эти пояснения в саму публикацию.
Оставьте свое сообщение

См. также

.Net в 1С. На примере использования HTTPClient, AngleSharp. Удобный парсинг сайтов с помощью библиотеки AngleSharp, в том числе с авторизацией аля JQuery с использованием CSS селекторов. Динамическая компиляция Промо

Практика программирования WEB v7.7 v8 Бесплатно (free)

Часто приходится парсить сайты, в том числе с авторизацией, перескакивая со страницы на страницу по ссылкам. Тот, кто занимался вэб программированием, знает, как удобно использовать JQuery и CSS селекторы. На .Net написана очень удобная библиотека AngleSharp. Я покажу, как с её помощью можно значительно облегчить себе труд.

10.03.2016    55763    Serginio    33    

Интеграционная прослойка(middleware) на Golang. Часть 5 - Обмен с 1С через HTTP-сервисы платформы

WEB v8 Бесплатно (free)

В этой статье научим прослойку отправлять данные в 1С, для этого используем HTTP-сервисы платформы. Обменяемся данными с новым справочником Клиенты. Но главное создадим HTTP-сервис для получения сообщений из очереди RabbitMQ.

вчера в 09:30    120    dmitry-irk38    0    

Отладка http сервиса

WEB v8 Бесплатно (free)

При разработке http сервиса возникает ситуация, а как протестировать http сервис? Создали мы сервис, настроили шаблоны, передали, если нужно параметры, открываем браузер заполняем строку подключения и БАХ, ошибка. Что делать?

23.09.2020    1023    hpi    6    

Учимся создавать http сервисы (часть вторая). Передача параметра в http сервис

WEB v8 1cv8.cf Бесплатно (free)

Пошаговое руководство по созданию http-сервиса (часть вторая). Передача параметра в http сервис.

22.09.2020    2445    hpi    4    

Online телефонный справочник из 1С: Зарплата и управление персоналом Промо

WEB Управление персоналом (HRM) Управление персоналом (HRM) v8 ЗУП3.x Россия Бесплатно (free)

В интернете представлено много реализаций online телефонных справочников организаций. Есть справочники, которые использует для хранения информации базу Active Directory (LDAP), есть справочники, которые реализованы с использованием СУБД (например, MySQL). Но я не нашел справочника, который использует информацию из базы 1С. Далее я рассмотрю данную разработку.

10.03.2017    25855    ruha    14    

Организация данных и вариант обработки для организации обмена с сайтом

WEB v8 1cv8.cf Бесплатно (free)

В статье опишу вариант организации данных и обработки для обмена с сайтом.

22.09.2020    469    malikov_pro    4    

Формирование списка документов и скачивание печатной формы документа через веб-сайт с использованием HTTP-сервиса, плюс особенности авторизации

Практика программирования Обмен данными 1С WEB v8 1cv8.cf Бесплатно (free)

В статье показан пример, как реализовать формирование списка документов клиента/пользователя по коду, а затем скачать его (документа) печатную форму по ссылке

18.09.2020    463    R_o_n_n_y    0    

Формирование HTTP запроса формата multipart/form-data с двоичными данными, используя ПотокВПамяти

WEB v8 1cv8.cf Бесплатно (free)

В статье опишу вариант формирования запроса

11.09.2020    1912    malikov_pro    11    

Кэширование COM-соединения. Три способа Промо

Практика программирования Перенос данных из 1С7.7 в 1C8.X Внешние источники данных WEB v8 Россия Бесплатно (free)

Статья о трех способах кэширования COM-соединения в 1С:Предприятии 8.x.

11.04.2013    41255    YPermitin    41    

Ферма приложений на Kubernetes

WEB v8 Бесплатно (free)

При эксплуатации большого количества информационных систем 1С, предоставляющих интернет-сервисы, возникают проблемы, связанные с зависимостью от производительности и стабильности веб-сервера. Как объединить отдельно стоящие веб-сервера с помощью платформы Kubernetes для централизованного мониторинга всех опубликованных интернет-сервисов на конференции Infostart Event 2019 Inception рассказал программист компании BIA Technologies Владимир Кирбаба.

24.08.2020    821    ComboBoy    0    

Использование шаблонного процессора для формирования HTML страниц

WEB v8 1cv8.cf Бесплатно (free)

В статье опишу использование шаблонного процессора Handlebars запущенного на Node.js

24.08.2020    1309    malikov_pro    26    

Загрузка или обновление файла на яндекс диске через rest-api

Практика программирования Файловые протоколы обмена, FTP WEB v8 Бесплатно (free)

Коллеги, в данной публикации я хочу поделиться кодом, с помощью которого можно загрузить файл на яндекс диск или обновить существующий.

12.08.2020    1439    pavelpribytkin96    10    

Заготовка для загрузки файлов по ftp Промо

WEB Перенос данных из 1C8 в 1C8 v8 1cv8.cf Бесплатно (free)

3 процедуры и 1 макет

03.06.2013    30444    anig99    6    

Самый простой парсинг и обработка веб-страниц в 1С

WEB Универсальные функции v8 1cv8.cf Бесплатно (free)

Рассмотрим самый простой парсинг веб-страниц средствами платформы 1С и еще некоторые полезные приемы работы с веб-страницами.

07.08.2020    4258    YPermitin    18    

Загрузка или обновление файла на гугл диске

Практика программирования Файловые протоколы обмена, FTP WEB v8 1cv8.cf Бесплатно (free)

Коллеги, в данной публикации я хочу поделиться кодом, с помощью которого можно загрузить файл на гугл диск или обновить существующий.

06.08.2020    1137    pavelpribytkin96    0    

Использование Yandex Translate (Яндекс.Переводчик)

WEB v8 1cv8.cf Бесплатно (free)

В статье опишу вариант подключения и использования Yandex Translate.

08.07.2020    1977    malikov_pro    6    

Когда хотим знать IP клиента...

WEB v8 Бесплатно (free)

В процессе разработки web приложения на 1С, и это не шутка))), а пожелание заказчика, возникла ситуации когда понадобилось знать, с какого IP подключался клиент.

03.07.2020    2919    IMihalev    10    

Ограничение доступа к HTTP публикациям 1С сервера используя NGINX

WEB v8 1cv8.cf Бесплатно (free)

В статье опишу вариант ограничения доступа к HTTP публикациям 1С сервера используя NGINX.

02.07.2020    6047    malikov_pro    0    

Структура обработки загрузки цен и остатков поставщика с примерами и комментариями

Внешние источники данных WEB v8 1cv8.cf Россия Бесплатно (free)

В статье опишу структуру обработки по загрузке цен и остатков от поставщика с примерами.

27.06.2020    1560    malikov_pro    0    

Вариант использования документа "Операция по Яндекс.Кассе" для других сервисов по оплате через интернет

WEB v8 1cv8.cf Россия Бесплатно (free)

В статье рассмотрю организацию эквайринга в УТ 11.4 и доработки для создания заказов на оплату к стороннему сервису, как пример Сбербанк.

24.06.2020    1126    malikov_pro    3    

Работа с AliExpress через API

WEB v8 Бесплатно (free)

В публикации опишу подход работы с API AliExpress и примеры кода.

23.06.2020    3319    malikov_pro    12    

История создания успешной системы чат-ботов на 1С

WEB v8 Бесплатно (free)

Использование чат-ботов в мессенджерах позволяет автоматизировать многие сложные бизнес-процессы путем диалога с системой через виртуального собеседника. О том, как создать универсальную систему ботов с бэкендом на 1С, работающую в Telegram, Viber и Facebook Messenger одновременно, на конференции Infostart Event 2019 Inception рассказал программист-фрилансер Константин Гейнрих.

21.05.2020    6854    CyberCerber    14    

Парсинг html страниц с выводом информации через JavaScript с использованием Selenium

WEB v8 1cv8.cf Бесплатно (free)

Есть девочки как девочки, есть мальчики как мальчики, есть сайтики как сайтики, но странички их обманщики. В целях сохранить информацию, от автоматизированного сбора, многие ресурсы пытаются защитить ее. Один из таких способов - вывод информации на странице через JavaScript. При получении такой страницы в 1С, JavaScript не успевает вывести необходимые данные, и в 1с получаем практически пустую страницу. В статье приведу пример разработки, для парсинга таких страниц, без регистрации и смс.

20.05.2020    3347    platonov.e    25    

Интеграция 1С и CMS WordPress посредством Rest API сайта. Шаг третий, WooCommerce, публикация категорий товаров

WEB v8 1cv8.cf Бесплатно (free)

Интеграция 1С и CMS WordPress посредством функционала Rest API. Используем только язык программирования 1С и штатный функционал Rest API предоставляемый CMS, без дополнительных библиотек и плагинов. Процедуры и функции публикации категорий товаров в магазин WooCommerce, с комментариями внутри.

13.05.2020    2840    osivv    3    

Интеграция 1С и CMS WordPress посредством Rest API сайта. Шаг второй, публикация картинок

WEB v8 Бесплатно (free)

Интеграция 1С и CMS WordPress посредством функционала Rest API. Используем только язык программирования 1С и штатный функционал Rest API предоставляемый CMS, без дополнительных библиотек и плагинов. Процедуры и функции передачи фото из 1С, с комментариями внутри.

13.05.2020    2073    osivv    0    

Интеграция Camunda BPM и 1С

WEB Интеграция v8 Бесплатно (free)

Быстрый старт. Только практические примеры. Установка, запуск и публикация бизнес-процесса на сервере Camunda BPM. Управление бизнес-процессами из 1С при помощи Camunda REST API.

12.05.2020    3500    zhichkin    19    

Интеграция 1С и CMS WordPress посредством Rest API сайта. Первый шаг

WEB v8 Россия Бесплатно (free)

Интеграция 1С и CMS WordPress посредством функционала Rest API. Используем только язык программирования 1С и штатный функционал Rest API предоставляемый CMS, без дополнительных библиотек и плагинов. Процедуры и функции 1С с комментариями внутри.

28.04.2020    4160    osivv    23    

Хранение статистики публикаций автора сообщества Инфостарт ® (мобильное приложение И ++)

Мобильная разработка WEB v8 1cv8.cf Бесплатно (free)

Инфостарт ® достаточно удобный в плане работы со своим личным кабинетом сайт. Но программисты тем и отличаются от большинства людей, что им хочется знать больше. Поэтому появилась конфигурация 1С (она же мобильное приложение 1С) для более подробного учета статистики публикаций: рейтинг, количество просмотров, количество комментариев в динамике и в разрезах.

24.04.2020    2292    capitan    15    

Интеграция УАТ с топливными сервисами

WEB v8 1cv8.cf Автомобили, автосервисы Бесплатно (free)

Интеграция конфигурации Управление автотранспортом с топливными веб-сервисами.

21.04.2020    7194    RPGrigorev    2    

Интеграция 1С с веб-сервисами Лукойл ЛИКАРД

WEB v8 1cv8.cf Россия Бесплатно (free)

Описание интерфейса взаимодействия сервиса Лукойл- ЛИКАРД с информационной системой 1С.

20.04.2020    3884    RPGrigorev    0    

Ошибка инициализации модуля: HTTPСервис

WEB v8 1cv8.cf Узбекистан Бесплатно (free)

Решение проблемы "Ошибка при работе с HTTP сервисом 500. Ошибка инициализации модуля".

13.04.2020    3046    VipDim    10    

COVID-19. Динамика эпидемии

WEB v8 v8::СКД 1cv8.cf Бесплатно (free)

Весной 2020 практически все ждут, «когда же это закончится», когда эпидемия пойдет на спад. Специалисты призывают «сгладить кривую». Как понять, в какой точке мы сейчас? Данные университета Джонса Хопкинса в любой 1С.

01.04.2020    3259    Alejandro_V    6    

Как я собрал для себя высокопроизводительный и бесплатный облачный бекенд для 1С на PosgreSQL + PostgREST

Производительность и оптимизация (HighLoad) WEB Интеграция Мобильная разработка Администрирование веб-серверов v8 Бесплатно (free)

В этой статье я расскажу о проблемах бека для мобильных приложений или другого фронта, который требует производительности, быстрой реакции и отказоустойчивости, и как я решил это благодаря opensource проекту PostgREST и СУБД Postgre SQL 12. Проведу простой тест производительности для сравнения 1С с данным решением. Это может быть полезно всем, кто разрабатывает мобильные приложения либо фронтсайд-приложения для 1С на чем угодно - на мобильной платформе или на нативном языке или на Simple UI. И также обзор новых функций SimpleUI для связи с этим бекендом.

31.03.2020    12608    informa1555    31    

Коронавирус COVID-19. Статистика по странам

WEB v8 Бесплатно (free)

В связи с COVID-19 люди поделились на две категории: те, кто осознал, и те кто ЕЩЕ не осознал. Единственное наше преимущество перед Коронавирусом заключается в том, что информация распространяется быстрее, чем расползается "невидимка".

25.03.2020    6263    Evgen.Ponomarenko    60    

Получение html-кода страницы. JS из 1С

Практика программирования WEB v8 Бесплатно (free)

Получение исходника страницы, выполнение произвольного js-кода. Теперь с WebKit от 1С.

18.02.2020    6171    Yashazz    1    

Отладка конфигурации в режиме веб-клиента

WEB v8 Бесплатно (free)

После очередного обновления платформы при попытке запуска отладки в веб-клиенте стало появляться сообщение. Собственно, до этого момента никогда веб-клиентом особо не пользовался и необходимости в отладке как-то не возникало. Данное сообщение заставило задуматься, что не так с отладкой в веб-клиенте и как ее собственно включить? Тот самый неловкий момент, когда программа просит обратиться к администратору, а администратор - это вы.

12.02.2020    4858    gamletspb    3    

Анализ работы внешней обработки сервиса МодульКасса применительно к задаче фискализации чеков при доставке

Кассовые операции WEB v8 УТ11 Россия Бесплатно (free)

В статье разберу работу внешней обработки для работы с МодульКасса, опишу недочеты и применимость для организации доставки, предложу собственный вариант реализации.

11.02.2020    2698    malikov_pro    0    

Вариант реализации работы с сервисом Dadata применительно к конфигурации УТ 11.4 и подобным

WEB v8 УТ11 Россия Бесплатно (free)

В статье описывается реализация получения данных с сервиса DaData при работе с формами справочников в конфигурации УТ 11 для дополнения информации по ФИО, ИНН, Адресу.

22.01.2020    3209    malikov_pro    7    

Двусторонний обмен с поставщиком через интернет-магазин для реализации товаров с ответственного хранения (с 01.02.2020 "Партии" не используются)

Файловые протоколы обмена, FTP WEB v8 УНФ Оптовая торговля, дистрибуция, логистика Россия УУ Бесплатно (free)

Рассмотрены реализация двустороннего обмена данными с использованием API-сервиса сайта поставщика при продаже товаров со склада ответственного хранения, алгоритм движения товаров и обмена документами на примере конфигурации 1С: УНФ у партнера, который взаимодействует с поставщиком "ООО Пауэр-Интернэшнл-шины" - одним из крупнейших в России поставщиков автомобильных шин и дисков.

16.01.2020    4386    chkurs    0    

Получение номера ВСД по идентификатору 1С: Меркурий

Производство готовой продукции (работ, услуг) WEB v8 УТ11 Пищевая промышленность Россия Бесплатно (free)

Код парсинга веб страницы для получения номера ВСД в системе Меркурий.

24.11.2019    4403    ohyen    0    

Немного о интеграции с CRM AMO

WEB v8 1cv8.cf Бесплатно (free)

Немного информации о том, как настроить интеграцию с CRM AMO. Пример функций для подключения к АМО и обновления заказа. Пример на основе API авторизации.

15.11.2019    4436    xxxAndricxxx    6    

Ещё немного о ИНН и сервисе DaData

WEB v8 1cv8.cf Бесплатно (free)

Об использовании сервиса dadata и немного информации о возможностях получать данные по ИНН. Возможно, кому-то будет полезным.

14.11.2019    7247    xxxAndricxxx    21    

Вариант реализации клиента SOAP на примере получения остатков из MERLION

WEB v8 1cv8.cf Россия Бесплатно (free)

В статье приведу пример клиента к сервису SOAP, функции которого принимают несколько значений типа строка или массив строк.

14.11.2019    3493    malikov_pro    0    

Разбор любого JSON-объекта в соответствующую структуру

Инструментарий разработчика WEB v8 1cv8.cf Бесплатно (free)

Данная публикация предназначена разработчикам 1С, которым приходиться разбирать данные формата JSON. Выложенный пример кода создает объект типа Структура, полностью повторяющий структуру данных формата JSON.

13.11.2019    9089    user665435_al.windstorm    15