Siirry sisältöön

HTTP ja REST

Yleisin pyyntötyyppi: kaikki mikä puhuu HTTP:tä, ensisijaisesti REST-API:t.

Napsauta projektipuuta hiiren oikealla painikkeella ▸ Lisää ▸ HTTP-pyyntö.

HTTP-pyynnön välilehti, jossa näkyvät URL, osiot Otsakkeet / Polkuparametrit / Parametrit / Sisältö sekä vastauspaneeli oikealla

GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS ja QUERY.

URL hyväksyy {{variables}} kaikissa osissaan — skeemassa, isännässä, portissa, polussa ja kyselymerkkijonossa. Ratkaistu arvo näkyy kentän alapuolella.

Kolme luetteloa täydentää URL-osoitetta:

  • kyselyparametrit (?clé=valeur)
  • polkuparametrit, jotka korvaavat polun nimetyt segmentit
  • otsakkeet

Jokaisella rivillä on valintaruutu, arvon tyyppi ja kuvaus.

Neljä perhettä:

TyyppiKäyttö
TekstiJSON, XML, pelkkä teksti — syntaksiväritys ja uudelleenmuotoilu
TiedostoLähettää levyllä olevan tiedoston sisällön
Lomake (multipart/form-data)Nimetyt kentät, myös tiedostot
x-www-form-urlencodedNimetyt kentät koodattuna sisältöön
  • Aikakatkaisu: millisekunteina, vain tälle pyynnölle; jos arvoa ei ole, käytetään globaalia asetusta.
  • Seuraa uudelleenohjauksia: käytössä oletuksena. Poista se käytöstä, jos haluat tarkastella 3xx-vastausta itseään ja sen Location-otsaketta.

Tilakoodi, kesto, koko, otsakkeet ja sisältö esitettynä sisältötyypin mukaan: tiivistettävä JSON-katselin, sisennetty XML, kuvan esikatselu tai pelkkä teksti. Historiavälilehdeltä pääsee aiempiin suorituksiin.

Liitä pyyntöön todennusreitti, niin otsakkeet lisätään ja token uusitaan automaattisesti. Katso Todennus.

Restorm osaa myös isännöidä HTTP-palvelinta, jolloin voit testata, miten asiakas käyttää sitä — tyypillisesti oman sovelluksesi koodi, jonka osoitat kokeilun ajaksi localhost-osoitteeseen.

Lisää palvelin valinnalla Lisää ▸ HTTP-palvelin: se kuuntelee osoitteessa localhost:<port><chemin> yhtä metodi + polku -paria ja vastaa sillä tilakoodilla, niillä otsakkeilla ja sillä sisällöllä, jotka siihen määritetään. Muita protokollia isännöidään samalla tavalla — katso Palvelintila ja HTTP-API:n simulointi.

Code Snippets -välilehdellä on tarjolla kaksikymmentäneljä kieltä ja kirjastoa: cURL, JavaScript (Fetch, Axios), TypeScript, Python (Requests, http.client, aiohttp), natiivi Node.js, Go, Rust (reqwest), Java (HttpClient, OkHttp), C# (HttpClient), PHP (cURL, Guzzle), Ruby (Net::HTTP, Faraday), Swift (URLSession), Kotlin (OkHttp), Dart, R (httr), PowerShell, Elixir (HTTPoison), Clojure (clj-http).

Onko sinulla OpenAPI-määritys, Postman-kokoelma, HAR-tiedosto tai pelkkä curl-komento? Tiedosto ▸ Tuo rakentaa puun puolestasi. Katso API:n tuonti.