Siirry sisältöön

Pika-aloitus (5 minuuttia)

Tavoite: lähteä tyhjästä asennuksesta ja päätyä todennettuun pyyntöön, jonka URL ja token tulevat muuttujista. Varaa viisi minuuttia.

Tiedosto ▸ Uusi (Ctrl+N) ja sitten Tiedosto ▸ Tallenna nimellä (Ctrl+Shift+S), jolla annat sille nimen, esimerkiksi demo.restorm.

Projekti on pelkkä tiedosto levylläsi. Voit sijoittaa sen git-arkistoon heti — Restorm on tehty juuri sitä varten.

Napsauta sivupuuta hiiren kakkospainikkeella ▸ Lisää ▸ Muuttujakansio.

Muuttujakansio (eli ympäristökansio) on säiliö, joka kantaa ympäristöjäsi — local, staging, production — ja siten myös {{muuttujiasi}}. Kaikki sen sisällä olevat pyynnöt perivät valitun ympäristön.

Avaa kansio, luo ympäristö local ja lisää siihen muuttuja:

AvainTyyppiArvo
baseUrlMerkkijonohttps://api.exemple.test

Muuttujakansion välilehti Ympäristöt-alavälilehdellä: valittu ympäristö vasemmalla ja sen muuttuja baseUrl oikealla

Napsauta kansiota hiiren kakkospainikkeella ▸ Lisää ▸ HTTP-pyyntö. Avautuvalla välilehdellä:

  • jätä metodiksi GET;
  • kirjoita URL {{baseUrl}}/health — ratkaistu arvo näkyy kentän alla, ja se on turvaverkkosi;
  • napsauta Send.

Vastaus avautuu alapuolelle: tila, aika, koko, otsakkeet ja sisältö tiivistettävässä JSON-katselimessa.

HTTP-pyyntö, jonka URL käyttää {{baseUrl}}-muuttujaa, ja vastauspaneeli avattuna oikealla — tila, aika, koko ja JSON-sisältö

Sen sijaan että liittäisit tokenin kovakoodattuna, luo todennuspyyntö: kakkospainike ▸ Lisää ▸ Todennuspyyntö. Määritä kutsu, joka hankkii tokenin (esimerkiksi POST /oauth/token), ja ilmoita sitten sen Kokoonpano-välilehdellä, mitä se tuottaa:

Tuotettu otsakeArvo
Authorization{{token_type}} {{access_token}}

Arvo on lauseke, joka evaluoidaan todennuspyynnön vastauksen sisällöstä. Täytä samalla vanhentumislauseke (esimerkiksi {{expires_in}}), jotta Restorm uusii tokenin itse.

Palaa GET-pyyntöösi ja valitse ylärivin palkista tämä todennusreitti. Otsake lisätään nyt jokaiseen lähetykseen, ja 401 käynnistää automaattisesti uusimisen ja sen jälkeen uuden yrityksen.

Yksityiskohdat: Todennus.

  • Onko sinulla jo määritys tai kokoelma? Tiedosto ▸ Tuo (Ctrl+I) rakentaa koko puun uudelleen: katso Tuonti ja vienti.
  • Ketjuta useita kutsuja ja tarkista tulokset skenaariolla.
  • Aja tämä skenaario omassa CI-ympäristössäsi: Headless-suoritus.