Avvio rapido · La prima richiesta in tre passi
Obiettivo: costruire una richiesta HTTP funzionante da zero. Una volta capita la linea principale «Gruppo → Ambiente → Richiesta», ogni altro protocollo è solo un protocollo diverso e un Pre-URL diverso.
Passo 1: crea un gruppo, associa un ambiente
In Quick Request, l'ambiente è associato al gruppo, e tutte le richieste del gruppo lo condividono.
- Crea un nuovo gruppo (es.
Il mio primo gruppo). - Associa un ambiente al gruppo. Se non ne hai ancora uno, crea prima un ambiente (es.
Locale).
Perché il livello in più? Perché quando un modulo si sposta tra dev / staging / produzione, vuoi modificare solo l'ambiente — non decine di richieste.
Passo 2: riempi il Pre-URL nell'ambiente
Un ambiente conserva un indirizzo base per protocollo. Per inviare HTTP, riempi la voce http:
| Riga protocollo | Indirizzo base di esempio | Note |
|---|---|---|
| HTTP | http://127.0.0.1:18080 | Usa https:// per abilitare TLS |
| WebSocket | ws://127.0.0.1:18085 | Usa wss:// per abilitare TLS |
| gRPC | grpc://127.0.0.1:18089 | Usa grpcs:// per abilitare TLS |
| MQTT | mqtt://127.0.0.1:18884 | Usa mqtts:// per abilitare TLS |
⚠️ La trappola più facile: a quale protocollo appartiene un indirizzo base è deciso dallo schema all'inizio dell'URL, non dalla riga in cui lo digiti. Un indirizzo base WebSocket deve essere scritto come
ws://…owss://…; se digiti per errorehttps://…, viene trattato come HTTP, la richiesta WebSocket non trova un indirizzo base e fallisce. Mantieni coerenti la riga del protocollo e lo schema.
(Le porte come 18080 sopra vengono dal server di test di esempio; sostituiscile con i tuoi indirizzi reali quando testi le tue API.)
Passo 3: crea una richiesta, riempi solo il frammento di percorso, invia
Crea una richiesta dentro il gruppo:
- Protocollo: HTTP; Metodo:
GET. - URL — riempi solo il frammento di percorso:
/echo(non l'host completo — l'host è già fornito dal Pre-URLhttpdell'ambiente). - Tocca Invia.
Vedrai /echo restituirti esattamente ciò che hai inviato. Quello che è realmente andato sul filo era http://127.0.0.1:18080/echo.
Funziona — e ora?
- Vuoi capire «perché solo
/echo» e «da dove viene{{x}}» → concepts - Vuoi firmare richieste prima dell'invio / decrittare risposte → scripting
- Vuoi copiare la ricetta «login per il token, auto-allega per tutto il gruppo» → recipes
- Cambiare protocollo (WS/TCP/UDP/gRPC/MQTT) → la pagina del protocollo corrispondente (vedi l'indice)