Sari la conținut

Pornire rapidă (5 minute)

Obiectiv: să porniți de la o instalare nouă și să ajungeți la o cerere autentificată, al cărei URL și token provin din variabile. Socotiți cinci minute.

Fișier ▸ Nou (Ctrl+N), apoi Fișier ▸ Salvează ca (Ctrl+Shift+S) pentru a-i da un nume, de exemplu demo.restorm.

Un proiect este pur și simplu un fișier pe discul dumneavoastră. Îl puteți pune într-un depozit git încă de acum — Restorm este făcut pentru asta.

Clic dreapta în arborele lateral ▸ Adaugă ▸ Folder de variabile.

Un folder de variabile (numit și folder de mediu) este containerul care poartă mediile dumneavoastră — local, staging, production — și, prin urmare, {{variabilele}}. Toate cererile pe care le conține moștenesc mediul selectat.

Deschideți-l, creați un mediu local și adăugați-i o variabilă:

CheieTipValoare
baseUrlȘirhttps://api.exemple.test

Fila unui folder de variabile, pe subfila Medii: mediul selectat în stânga și variabila sa baseUrl în dreapta

Clic dreapta pe folder ▸ Adaugă ▸ Cerere HTTP. În fila care se deschide:

  • lăsați metoda pe GET;
  • introduceți URL-ul {{baseUrl}}/health — valoarea rezolvată se afișează sub câmp, este plasa dumneavoastră de siguranță;
  • faceți clic pe Send.

Răspunsul se deschide dedesubt: stare, timp, dimensiune, antete și corpul redat într-un vizualizator JSON pliabil.

O cerere HTTP al cărei URL folosește {{baseUrl}}, cu panoul de răspuns deschis în dreapta — stare, timp, dimensiune și corp JSON

În loc să lipiți un token codificat direct, creați o cerere de autentificare: clic dreapta ▸ Adaugă ▸ Cerere de autentificare. Configurați apelul care obține tokenul (de exemplu un POST /oauth/token), apoi, în fila sa Configurare, declarați ce produce:

Antet produsValoare
Authorization{{token_type}} {{access_token}}

Valoarea este o expresie evaluată pe corpul răspunsului cererii de autentificare. Completați totodată expresia de expirare (de exemplu {{expires_in}}) pentru ca Restorm să reînnoiască singur tokenul.

Reveniți la cererea GET și, în bara de sus, alegeți această rută de autentificare. Antetul este de acum injectat la fiecare trimitere, iar un 401 declanșează automat o reînnoire, urmată de o nouă încercare.

Detalii: Autentificare.

  • Aveți deja o specificație sau o colecție? Fișier ▸ Importă (Ctrl+I) reconstruiește tot arborele: vedeți Import & export.
  • Înlănțuiți mai multe apeluri și verificați rezultatele cu un scenariu.
  • Rulați acest scenariu în CI: Rulare headless.