Դիտել հիմնական բովանդակությունը

Узел http request

Ուզել http request նախատեսված է արտաքին վեբ-ծառայություններին կամ API-ներին HTTP-հարցեր կատարելու համար: Այն աջակցում է HTTP-ի բազմաթիվ մեթոդների, տվյալների տեսակների, վավերացման և հարցերի ու պատասխանների ճկուն կառավարմանը:

Настройки узла http request​

IMG2

1. Name​

Դաշտ անունը նշելու համար:
Անունը ցուցադրվում է աշխատանքային տարածքում և օգնում է հեշտությամբ նույնականացնել узелը:
Եթե թողնել դատարկ, узелը կկոչվի http request.

Օրինակ:

  • Անուն узелի: Get Weather Data

2. Method​

HTTP-մեթոդ, որը կօգտագործվի հարցման համար: Մեթոդի ընտրությունը կախված է այն գործողության տեսակից, որը պետք է իրականացվի:

Հասանելի մեթոդներ:

  • GET: Տվյալների ստացում:
  • POST: Տվյալների ուղարկում:
  • PUT: Տվյալների թարմացում:
  • DELETE: Տվյալների հեռացում:
  • PATCH: Տվյալների մասնակի թարմացում:
  • HEAD: Պատասխանի գլխիկների ստացում:
  • OPTIONS: API-ի մասին տեղեկատվության ստացում:

Օրինակ:

  • Method: POST

Դաշտ ստատիկ URL-հասցեն նշելու համար, որի վրա կուղարկվի հարցումը:
Եթե հասցեն պետք է սահմանել դինամիկ, այն կարելի է փոխանցել msg.url.

Օրինակ:

  • Link: https://api.example.com/data

4. Data​

Նշում է, թե ինչպես կավելացվեն մուտքային տվյալները HTTP-հարցմանը: Հասանելի են հետևյալ տարբերակները:

  1. Ignore:
    Մուտքային տվյալները չեն օգտագործվի հարցման մեջ: Դաշտ msg.payload, եթե այն գոյություն ունի, կ忽略վի:

    Օրինակ:
    Եթե msg.payload պարունակում է JSON-օբյեկտ, այն չի ներառվի հարցման մեջ:

  1. Add to query parameters:
    Տվյալները msg.payload-ից կվերածվեն հարցման պարամետրերի (Query Parameters) և կավելացվեն URL-ին:

    Օրինակ:
    Եթե msg.payload պարունակում է:

    {
      "key1": "value1",
      "key2": "value2"
    }

    Եթե Link-ը նշված է որպես http://example.com/api, ապա վերջնական հարցումը կլինի:
    GET http://example.com/api?key1=value1&key2=value2.

  1. Send as request body (Отправить в теле запроса):
    Տվյալները msg.payload-ից կուղարկվեն հարցման մարմնում: Այս տարբերակը հարմար է POST, PUT, և PATCH մեթոդների համար, որտեղ տվյալները հաճախ փոխանցվում են մարմնում:

    Օրինակ:
    Եթե msg.payload պարունակում է:

    {
      "name": "John Doe",
      "email": "john.doe@example.com"
    }

    Եթե հարցման մեթոդը POST է, տվյալները կուղարկվեն հարցման մարմնում համապատասխան բովանդակությամբ:

5. Return​

Նշում է, թե ինչ ձևաչափով узелը կաշխատի սերվերից ստացված պատասխանին:

Վարիանտներ:

  • UTF-8 string: Պատասխանը վերածվում է տողի (հիմնականում):
  • Buffer: Պատասխանը վերադարձվում է Buffer օբյեկտի տեսքով (օգտակար է բինարային տվյալների, ինչպիսիք են պատկերները կամ ֆայլերը):
  • JSON: Եթե սերվերի պատասխանը JSON ձևաչափով է, այն ավտոմատ կերպով վերածվում է JavaScript օբյեկտի:

Օրինակ:

  • Եթե ընտրված է JSON, պատասխան: 
    {"status": "ok", "value": 42}
    Վերածվում է: 
    msg.payload = { status: "ok", value: 42 };

6. Authentication​

Ուզելն աջակցում է ներառված վավերացման մեխանիզմներին:

Basic Auth​

  • Username: Օգտագործողի անուն:
  • Password: Գաղտնաբառ:

Bearer Token​

  • Token: մուտքի տոմս:

Digest​

  • Username: Օգտագործողի անուն:
  • Password: Գաղտնաբառ:

Входные данные​

Ուզել http request ընդունում է msg հաղորդագրության օբյեկտ, որը պարունակում է պարամետրեր:

  1. msg.url: URL հարցման համար (եթե այն չի նշված узլի կարգավորումներում):
  2. msg.method: HTTP-մեթոդ (եթե չի սահմանված узլի կարգավորումներում):
  3. msg.payload: Հարցման մարմին (օգտագործվում է POST, PUT, PATCH մեթոդների համար):
  4. msg.headers: HTTP-հարցման գլխիկներ (օբյեկտ):

Выходные данные​

Ուզելն վերադարձնում է msg օբյեկտ, որը պարունակում է տեղեկություններ կատարված հարցման մասին:

  1. msg.payload: Սերվերից ստացված տվյալները:
  2. msg.statusCode: HTTP-պատասխանային կոդ (օրինակ, 200 կամ 404).
  3. msg.headers: Պատասխանի գլխիկներ:
  4. msg.responseUrl: URL, որի վրա կատարվել է հարցումը:
  5. msg.error: Ошибка նկարագրություն (եթե հարցումը ավարտվել է անհաջող):

Примеры использования​

Пример 1: Выполнение GET-запроса​

Настройки узла:

  • Method: GET
  • URL: https://api.weatherapi.com/v1/current.json?key=API_KEY&q=London

Поток:

[inject] ---> [http request] ---> [debug]

Результат: Узел вернет JSON с текущей погодой.

Пример 2: Отправка данных через POST​

Настройки узла:

  • Method: POST
  • URL: https://api.example.com/devices
  • Data: JSON

Поток:

[function] ---> [http request] ---> [debug]

Код в узле function:

msg.payload = {
    deviceId: "sensor123",
    status: "active"
};
msg.headers = { "Content-Type": "application/json" };
return msg;

Результат: Данные будут отправлены, а узел вернет ответ сервера.

Пример 3: Динамический URL и аутентификация​

Настройки узла:

  • URL: (оставить пустым)

Поток:

[function] ---> [http request] ---> [debug]

Код в узле function:

msg.url = "https://api.example.com/user/123";
msg.headers = { Authorization: "Bearer YOUR_TOKEN" };
return msg;

Результат: Узел выполнит запрос к указанному URL с токеном аутентификации.