Roboteka
Roboteka · Roboty · Żądanie HTTP GET/POST

Żądanie HTTP GET/POST

Robot „Żądanie HTTP GET/POST” wysyła żądanie do zewnętrznego API z procesu biznesowego. Przyjmuje URL, metodę (GET, POST, PUT, PATCH, DELETE, HEAD), treść żądania, nagłówki w formacie JSON oraz limit czasu i zwraca treść odpowiedzi, kod statusu HTTP oraz flagę sukcesu (Y/N). Działa w procesach biznesowych i robotach Bitrix24 (Alaio).

Robot wykonuje żądanie HTTP do zewnętrznego API bezpośrednio z procesu biznesowego Bitrix24 (Alaio) — bez kodu i usług pośredniczących. Obsługuje metody GET, POST, PUT, PATCH, DELETE i HEAD, dowolną treść żądania, nagłówki w formacie JSON (np. Authorization) oraz limit czasu od 1 do 60 sekund. Typowe przypadki: przekazanie danych deala do zewnętrznego systemu księgowego lub odpytanie API firmy kurierskiej o status zamówienia. Przekierowania (do 5) są weryfikowane na każdym kroku, żądania do wewnętrznych adresów sieciowych są blokowane, a treść odpowiedzi jest ograniczona do 1 MB. Zwraca treść odpowiedzi, kod statusu HTTP i flagę sukcesu (Y/N): odpowiedź można rozłożyć robotem „Wyodrębnij wartość z JSON po ścieżce”, a na podstawie flagi zbudować warunek w projektancie procesów. Nie działa, dopóki Bitrix24 jest w trybie demo.

Jakie parametry wejściowe przyjmuje robot?

Parametr Typ Wymagany? Domyślnie
URL string tak
Metoda HTTP (domyślnie GET) select GET, POST, PUT, PATCH, DELETE, HEAD — GET
Treść żądania (dla POST/PUT) string —
Nagłówki jako JSON: {"Authorization":"Bearer xxx","Content-Type":"application/json"} string —
Limit czasu w sekundach (domyślnie 10) int —

Co zwraca robot?

Parametr Typ
Treść odpowiedzi string
Kod statusu HTTP int
Sukces (Y/N) — kod 2xx string

Jakie błędy może zwrócić robot?

Te komunikaty robot zapisuje w dzienniku procesu biznesowego, gdy nie może wykonać kroku. Z treści widać, co poprawić w ustawieniach lub danych.

  • Błąd: metoda musi być jedną z {methods}
  • Błąd: nagłówki muszą być obiektem JSON
  • Błąd: nieprawidłowa nazwa nagłówka: {name}
  • Błąd: znaki sterujące w nagłówku {name} są niedozwolone
  • Błąd: nagłówek {name} jest ustawiany automatycznie
  • Błąd cURL: {error}
  • Ten robot nie działa, dopóki Bitrix24 jest w trybie demo lub jeśli nie udało się ustalić planu.

Scenariusz: odpytanie zewnętrznej usługi o status zamówienia

  1. Deal przechodzi na etap „Dostawa” i uruchamia robota
  2. Robot wysyła żądanie GET do API firmy kurierskiej z numerem zamówienia
  3. Robot „Wyodrębnij wartość z JSON” wyciąga status z odpowiedzi
  4. Status zostaje zapisany w polu deala i jest widoczny dla menedżera

Podobne roboty

Powiązane artykuły

Zainstaluj Opisz zadanie — zbudujemy robota bezpłatnie