Gå til innholdet

Hurtigstart (5 minutter)

Målet: gå fra en helt fersk installasjon til en autentisert forespørsel der både URL-en og tokenet kommer fra variabler. Regn med fem minutter.

Fil ▸ Ny (Ctrl+N), deretter Fil ▸ Lagre som (Ctrl+Shift+S) for å gi prosjektet et navn, for eksempel demo.restorm.

Et prosjekt er bare en fil på disken din. Du kan legge det i et git-repositorium med en gang — Restorm er laget for det.

Høyreklikk i sidefeltet ▸ Legg til ▸ Miljømappe.

En miljømappe (også kalt variabelmappe) er beholderen som holder miljøene dine — local, staging, production — og dermed også {{variables}}. Alle forespørslene den inneholder, arver det valgte miljøet.

Åpne den, opprett miljøet local og legg til en variabel i det:

NøkkelTypeVerdi
baseUrlStrenghttps://api.exemple.test

Fanen for en miljømappe, på underfanen Miljøer: det valgte miljøet til venstre og variabelen baseUrl til høyre

Høyreklikk på mappen ▸ Legg til ▸ HTTP-forespørsel. I fanen som åpnes:

  • la metoden stå på GET;
  • skriv inn URL-en {{baseUrl}}/health — den oppløste verdien vises under feltet, og er sikkerhetsnettet ditt;
  • klikk på Send.

Svaret åpnes under: status, tid, størrelse, headere, og kroppen gjengitt i en sammenleggbar JSON-viser.

En HTTP-forespørsel der URL-en bruker {{baseUrl}}, med svarpanelet åpent til høyre — status, tid, størrelse og JSON-kropp

I stedet for å lime inn et hardkodet token bør du opprette en autentiseringsforespørsel: høyreklikk ▸ Legg til ▸ Autentiseringsforespørsel. Sett opp kallet som henter tokenet (for eksempel en POST /oauth/token), og erklær deretter i fanen Konfigurasjon hva forespørselen produserer:

Produsert headerVerdi
Authorization{{token_type}} {{access_token}}

Verdien er et uttrykk som evalueres mot kroppen i svaret fra autentiseringsforespørselen. Fyll samtidig inn uttrykket for utløp (for eksempel {{expires_in}}) slik at Restorm fornyer tokenet av seg selv.

Gå tilbake til GET-forespørselen din og velg denne autentiseringsruten i linjen øverst. Headeren blir nå injisert ved hver sending, og en 401 utløser automatisk en fornyelse og deretter et nytt forsøk.

Detaljer: Autentisering.

  • Har du allerede en spesifikasjon eller en samling? Fil ▸ Importer (Ctrl+I) bygger hele treet på nytt: se Import og eksport.
  • Lenk sammen flere kall og kontroller resultatene med et scenario.
  • Kjør dette scenarioet i CI-en din: Headless kjøring.