Gå til indhold

Hurtig start (5 minutter)

Målet: at starte fra en frisk installation og ende med en anmodning med godkendelse, hvor både URL og token kommer fra variabler. Regn med fem minutter.

Fil ▸ Ny (Ctrl+N), derefter Fil ▸ Gem som (Ctrl+Shift+S) for at give det et navn, for eksempel demo.restorm.

Et projekt er blot en fil på din disk. Du kan lægge det i et git-repository med det samme — Restorm er lavet til netop det.

Højreklik i træstrukturen i sidepanelet ▸ Tilføj ▸ Miljømappe.

En miljømappe (også kaldet en variabelmappe) er den beholder, der bærer dine miljøer — local, staging, production — og dermed dine {{variables}}. Alle anmodninger i mappen arver det valgte miljø.

Åbn mappen, opret et miljø local og tilføj en variabel til det:

NøgleTypeVærdi
baseUrlStrenghttps://api.exemple.test

Fanen for en miljømappe på underfanen Miljøer: det valgte miljø til venstre og dets variabel baseUrl til højre

Højreklik på mappen ▸ Tilføj ▸ HTTP-anmodning. I den fane, der åbner:

  • lad metoden stå på GET;
  • skriv URL’en {{baseUrl}}/health — den beregnede værdi vises under feltet, og det er dit sikkerhedsnet;
  • klik på Send.

Svaret åbner nedenunder: status, tid, størrelse, headere og bodyen vist i en JSON-fremviser, du kan folde sammen.

En HTTP-anmodning, hvis URL bruger {{baseUrl}}, med svarpanelet åbent til højre — status, tid, størrelse og JSON-body

I stedet for at indsætte et hårdkodet token skal du oprette en godkendelsesanmodning: højreklik ▸ Tilføj ▸ HTTP-godkendelsesanmodning. Opsæt det kald, der henter tokenet (for eksempel et POST /oauth/token), og erklær derefter på anmodningens fane Konfiguration, hvad den producerer:

Produceret headerVærdi
Authorization{{token_type}} {{access_token}}

Værdien er et udtryk, der evalueres på svarets body fra godkendelsesanmodningen. Udfyld samtidig udtrykket for udløb (for eksempel {{expires_in}}), så Restorm fornyer tokenet af sig selv.

Gå tilbage til din GET-anmodning og vælg den godkendelsesrute i bjælken øverst. Headeren indsættes nu ved hver afsendelse, og en 401 udløser automatisk en fornyelse og derefter et nyt forsøg.

Detaljer: Godkendelse.

  • Har du allerede en specifikation eller en samling? Fil ▸ Importér (Ctrl+I) genopbygger hele træstrukturen: se Import og eksport.
  • Kæd flere kald sammen og kontrollér resultaterne med et scenarie.
  • Kør det scenarie i din CI: Headless-kørsel.