Simulace HTTP API

Klikněte pravým tlačítkem na složku ▸ Přidat ▸ Server HTTP.

Konfigurace

Server se konfiguruje týmiž poli jako požadavek — a právě v tom je jeho půvab: metoda a cesta definují trasu, na které se naslouchá, stav, hlavičky a tělo definují obsluhovanou odpověď.

Pole	Role
Metoda	Metoda dané trasy
Adresa	localhost:<port><cesta> — hostitel je pevně daný
Stav simulace	Vracený kód, ve výchozím stavu 200
Hlavičky	Hlavičky odpovědi
Tělo	Tělo odpovědi

Směrování

Trasa je dvojice metoda + cesta. Párování probíhá na přesnou cestu, dotazovací řetězec se ignoruje. Každé volání, které přijde na port a žádné trase neodpovídá, dostane 404.

Dvě trasy si vzájemně kolidují jen tehdy, sdílejí-li tutéž metodu, tutéž cestu a tentýž port. Můžete si tedy vytvořit jeden serverový požadavek na každou trasu a spustit je všechny.

GET  localhost:8080/clients      → 200, seznam klientů
GET  localhost:8080/clients/42   → 200, jeden klient
POST localhost:8080/clients      → 201, hlavička Location
GET  localhost:8080/clients/999  → 404 (žádná trasa: výchozí odpověď)

Šablony

Hlavičky a tělo se vyhodnocují při každém příchozím volání. Tělo obsahující {{maintenant}} nebo {{compteur}} se tedy mezi voláními mění, pokud se změní příslušná proměnná.

Tip: díky tomu lze řídit chování serveru za jeho běhu — změňte hodnotu proměnné prostředí a následující volání dostane jinou odpověď, bez restartu.

Sdílení portu

Simulační server HTTP a server WebSocket nebo Socket.IO mohou naslouchat na tomtéž portu: Restorm směruje běžné požadavky na trasy HTTP a žádosti o přepnutí na server pracující v reálném čase.

Ve scénáři

Akce Server HTTP hostuje trasu po dobu trvání scénáře a vysílá událost served — nesoucí { request, response } — na každé přijaté volání. Právě tak se testuje webhook:

Server HTTP ──connected──► Požadavek HTTP „spustit webhook“
    └────────served──────► Assert nad request.body
                            potom ──► Zavřít server HTTP

Viz Hostované servery.