Gyors kezdés (5 perc)

A cél: friss telepítésből eljutni egy hitelesített kérésig, amelynek URL-je és tokenje változókból származik. Nagyjából öt perc.

1. Projekt létrehozása

Fájl ▸ Új (Ctrl+N), majd Fájl ▸ Mentés másként (Ctrl+Shift+S) a névadáshoz, például demo.restorm.

A projekt egyszerű fájl a lemezen. Akár most rögtön elhelyezhető egy git tárházban — a Restormot pontosan erre tervezték.

2. Változómappa létrehozása

Jobb kattintás az oldalsáv fájában ▸ Hozzáadás ▸ Változómappa.

A változómappa (vagy környezeti mappa) az a tároló, amely a környezeteket — local, staging, production — és ezzel a {{változókat}} hordozza. A benne lévő összes kérés a kiválasztott környezetet örökli.

Megnyitás után létre kell hozni egy local környezetet, és fel kell venni bele egy változót:

Kulcs	Típus	Érték
baseUrl	Karakterlánc	https://api.exemple.test

3. Kérés létrehozása és elküldése

Jobb kattintás a mappán ▸ Hozzáadás ▸ HTTP-kérés. A megnyíló lapon:

• a metódus maradhat GET;
• az URL mezőbe a {{baseUrl}}/health érték kerül — a feloldott érték a mező alatt jelenik meg, ez a biztonsági háló;
• majd következik a Send gomb.

A válasz alatta nyílik meg: állapot, idő, méret, fejlécek, és a törzs egy összecsukható JSON-nézegetőben megjelenítve.

4. Hitelesítés hozzáadása

Ahelyett, hogy egy token bedrótozva kerülne a kérésbe, érdemes hitelesítési kérést létrehozni: jobb kattintás ▸ Hozzáadás ▸ Hitelesítési kérés. Ezután be kell állítani a tokent megszerző hívást (például egy POST /oauth/token), majd a Konfiguráció lapján megadni, hogy mit állít elő:

Előállított fejléc	Érték
Authorization	{{token_type}} {{access_token}}

Az érték a hitelesítési kérés válaszának törzsén kiértékelt kifejezés. Érdemes mindjárt a lejárati kifejezést is megadni (például {{expires_in}}), hogy a Restorm magától megújítsa a tokent.

Ezután a GET kéréshez visszatérve a felső sávban ki kell választani ezt a hitelesítési útvonalat. A fejléc innentől minden küldéskor bekerül a kérésbe, egy 401 válasz pedig automatikusan megújítást, majd újrapróbálkozást vált ki.

Részletek: Hitelesítés.

5. Hogyan tovább

• Van már specifikáció vagy gyűjtemény? A Fájl ▸ Importálás (Ctrl+I) az egész fát felépíti: lásd Import és export.
• Több hívás láncolása és az eredmények ellenőrzése forgatókönyvvel történik.
• A forgatókönyv a CI-ben is futtatható: Headless futtatás.