Passa al contenuto principale

HTTP (vista sviluppatore)

Il protocollo request/response senza stato più comune. Un «invio» è un round trip completo.

Come configurare nella UI​

  1. Protocollo: HTTP; Metodo: GET/POST/…
  2. URL — riempi il frammento di percorso (es. /echo); l'host arriva dal Pre-URL http dell'ambiente (vedi concepts).
  3. Riempi params, headers e Body secondo necessità.
  4. Per auth / crittografia / asserzioni, aggiungi azioni di pre-invio / post-risposta (vedi scripting).

Forme comuni del body: none / form-urlencoded / multipart / JSON / raw. Scegli il tipo giusto e lo strumento imposta Content-Type per te.

Autenticazione​

Le richieste possono usare i tipi di auth integrati:

In pratica, «accedi una volta, allega ovunque» di solito si fa iniettando il Bearer via script (vedi recipes, scenario 1) — meno ripetitivo che configurare l'auth su ogni richiesta, e segue automaticamente i refresh del login.

  • Cookie: con la policy cookie dell'ambiente impostata su «auto», i cookie vengono iniettati automaticamente e Set-Cookie viene salvato; una singola richiesta può sovrascriverlo.
  • Impostazioni di trasporto (per richiesta, sovrascrivono i predefiniti dell'ambiente): proxy, verifica o meno dei certificati TLS, timeout di connessione/ricezione, seguire o meno i redirect e numero massimo di hop, conteggio dei retry, ecc.

Un esempio completo​

POST /echo con un corpo JSON: {"hello":"world"} → il server restituisce in eco {method,url,args,headers,body,contentType,origin}.

Il server di test fornisce anche questi scenari tipici per esercitarsi:

PercorsoScopo
/echoRestituisce in eco la richiesta così com'è
/jsonRestituisce JSON strutturato (esercizio di estrazione/asserzione)
/oauth2/token + /protectedLogin per il token → accesso autorizzato (recipes, scenario 1)
/basic-auth, /bearerVerifica dell'auth integrata
/status/{code}Restituisce il codice di stato indicato
/redirect/3Redirect multi-hop
/delayRisposta lenta (esercizio sui timeout)
/charset/gbkCodifica non UTF-8 (esercizio di debug del testo illeggibile, vedi faq)

Punti di attenzione​

  • L'invio fallisce con «no base address»: molto probabilmente il gruppo non è associato a un ambiente che ha un Pre-URL http, oppure lo scheme del Pre-URL è sbagliato.
  • 401/403: conferma che lo script di pre-invio inietti davvero il token (disattivare temporaneamente gli script dovrebbe dare 401 — utile per localizzare il problema).
  • Testo cinese illeggibile nella risposta: controlla il charset restituito dal server, vedi faq.

Correlati: ambienti, variabili e meccanismo di assemblaggio in concepts.