Mini-proiect: mesajul de dimineață cu vremea
E timpul să pui cap la cap ce ai învățat: un trigger, un nod care aduce date dintr-un serviciu extern, expresii și Edit Fields. Construiești un workflow care află vremea din Cluj și scrie un mesaj de dimineață pentru colegii TehnoPlus, gata de trimis (trimiterea pe Slack sau pe email o adaugi în modulele următoare).
Ce construiești
Echipa TehnoPlus are depozitul în Cluj. Maria vrea ca, în fiecare dimineață, colegii să afle vremea: dacă plouă, curierii pleacă mai devreme. Workflow-ul are trei pași:
Rezultatul final, pentru Cluj, va fi:
Bună dimineața! În Cluj sunt 5 grade, ploaie slabă.
Nodul HTTP Request, pe scurt
HTTP Request este nodul care „sună” la alt program prin internet și îi cere date. Programul care răspunde se numește API (o „ușă” prin care programele vorbesc între ele, cum e ghișeul unei bănci: tu dai cererea, primești răspunsul). Totul despre API-uri înveți în modulul al treilea; acum ai nevoie doar de două setări:
| Parametru | Ce pui | De ce |
|---|---|---|
| Method | GET | GET înseamnă „dă-mi date” (doar citești, nu schimbi nimic) |
| URL | https://api.exemplu.ro/vreme?oras=Cluj | adresa la care se cere vremea |
API-ul https://api.exemplu.ro este unul de test, pregătit pentru curs. Îl găsești descris în panoul din dreapta, la Aplicații → API-uri. În realitate ai folosi un serviciu meteo adevărat, de exemplu OpenWeatherMap, care funcționează la fel.
Parametrul din adresă (query)
Uită-te la partea de după semnul întrebării din URL: ?oras=Cluj. Acesta este un parametru de interogare (query parameter): o informație în plus pe care o trimiți odată cu cererea, ca atunci când spui la ghișeu „vreau extrasul de cont pentru luna martie”.
- ? desparte adresa de parametri.
- oras=Cluj este perechea nume = valoare.
- Dacă ai mai mulți parametri, îi legi cu &: ?oras=Cluj&unitate=C.
Deocamdată scrii parametrul direct în URL. În modulul despre API-uri vei vedea că HTTP Request are și o secțiune separată pentru parametri (Send Query Parameters), mai ușor de citit când sunt mulți.
Dacă uiți parametrul, API-ul răspunde cu o eroare 400 (cerere greșită): „Lipsește parametrul oras”. Iar pentru un oraș pe care nu îl cunoaște, cu 404.
Ce răspunde API-ul
Pentru ?oras=Cluj, nodul HTTP Request dă un singur item:
{
"oras": "Cluj",
"temperatura": 5,
"descriere": "Ploaie slabă",
"unitate": "°C"
}Ai acum toate ingredientele. În Edit Fields scrii un text în care pui câmpurile cu expresii, ca în lecția 6, și folosești o funcție din lecția 7 ca descrierea să apară cu literă mică în mijlocul propoziției:
Bună dimineața! În {{ $json.oras }} sunt {{ $json.temperatura }} grade, {{ $json.descriere.toLowerCase() }}.Numele câmpurilor trebuie să fie exact cele din răspuns: temperatura, nu temperatură sau temp. Deschide Output-ul nodului HTTP Request și trage câmpurile din Input-ul lui Edit Fields, ca să nu greșești.
Ordinea în care lucrezi
Acesta este felul în care lucrează și profesioniștii: construiesc un pas, îl testează, apoi trec la următorul. Nu scrii tot workflow-ul dintr-odată ca să descoperi la final că primul pas nu mergea.
Exemple din viața reală
Dacă plouă, mesajul de dimineață îi anunță pe curieri să ia folie pentru colete.
Același workflow, cu alt URL, aduce cursul euro al zilei pentru echipa de achiziții.
Un HTTP Request către un API de știri și un mesaj cu primele titluri, gata de trimis echipei de marketing.
Construiește workflow-ul pentru mesajul de dimineață: după trigger adaugă un HTTP Request care cere vremea din Cluj și un Edit Fields care compune mesajul.
- Adaugă după trigger un nod HTTP Request cu Method GET și URL https://api.exemplu.ro/vreme?oras=Cluj.
- Adaugă după HTTP Request un nod Edit Fields cu câmpul mesaj (String).
- Valoarea: Bună dimineața! În {{ $json.oras }} sunt {{ $json.temperatura }} grade, {{ $json.descriere.toLowerCase() }}.
- Apasă Execute workflow și verifică mesajul în Output.
Soluția exercițiului
1. + de la ieșirea trigger-ului → HTTP Request: Method GET, URL https://api.exemplu.ro/vreme?oras=Cluj
2. + de la ieșirea lui HTTP Request → Edit Fields.
3. Add Field: mesaj (String) = Bună dimineața! În {{ $json.oras }} sunt {{ $json.temperatura }} grade, {{ $json.descriere.toLowerCase() }}.
4. Apasă Execute workflow. 