Passa al contenuto principale

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.

  1. Crea un nuovo gruppo (es. Il mio primo gruppo).
  2. 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 protocolloIndirizzo base di esempioNote
HTTPhttp://127.0.0.1:18080Usa https:// per abilitare TLS
WebSocketws://127.0.0.1:18085Usa wss:// per abilitare TLS
gRPCgrpc://127.0.0.1:18089Usa grpcs:// per abilitare TLS
MQTTmqtt://127.0.0.1:18884Usa 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://… o wss://…; se digiti per errore https://…, 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:

  1. Protocollo: HTTP; Metodo: GET.
  2. URL — riempi solo il frammento di percorso: /echo (non l'host completo — l'host è già fornito dal Pre-URL http dell'ambiente).
  3. 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)