REST API - методы REST и JSON в роботах и БП

Автоматизация часто упирается в момент, когда роботу нужны свежие данные из портала: название сделки, поля карточки, статус элемента. Обычно это обходят костылями или внешними сервисами. Это приложение закрывает задачу внутри процесса: шаг «REST-запрос» вызывает REST своего портала, принимает JSON и через JSONPath сразу отдаёт значение в следующие шаги.

Какие задачи решает

• подтянуть данные карточки в момент смены стадии и записать их дальше по процессу;
  
• проверить ответ API и выбрать ветку: успех, ошибка, пустое значение;
  
• собрать цепочку из нескольких REST-шагов без внешних посредников;
  
• отладить вызовы по журналу в экране приложения.
  

Работает в роботах CRM и в бизнес-процессах. Вызывается только REST текущего портала, произвольные внешние URL недоступны. Отдельной квоты на число запросов в автоматизации нет.

Поля шага

1. REST-метод, например crm.deal.get
   
2. Параметры (JSON), например {"id":"{=Document:ID}"}
   
3. JSONPath, например $.TITLE (если пусто, берётся весь ответ)
   

Что получите в процессе

• Результат: извлечённое значение
  
• Ошибка: пусто при успехе, иначе короткий код вроде E_REST: …
  

Примеры

ID подставьте через кнопку ... или шаблон {=Document:ID}.

Как начать

1. Установите приложение (нужно право на бизнес-процессы).
   
2. В роботе или бизнес-процессе добавьте «REST-запрос».
   
3. Укажите метод, JSON и JSONPath, сохраните.
   
4. В следующих шагах используйте Результат и Ошибка.
   

Важно

• если у метода нет нужного права у приложения, в «Ошибке» будет E_REST;
  
• приложение без лимитов;
  
• встройки в карточки не добавляются.