Avvio rapido (5 minuti)

Obiettivo: partire da un’installazione nuova e arrivare a una richiesta autenticata il cui URL e il cui token provengono da variabili. Servono circa cinque minuti.

1. Creare un progetto

File ▸ Nuovo (Ctrl+N), poi File ▸ Salva con nome (Ctrl+Shift+S) per assegnargli un nome, per esempio demo.restorm.

Un progetto è un semplice file sul disco. È possibile collocarlo subito in un repository git — Restorm è fatto per questo.

2. Creare una cartella di variabili

Clic destro nell’albero laterale ▸ Aggiungi ▸ Cartella di variabili.

Una cartella di variabili (o cartella di ambiente) è il contenitore che ospita gli ambienti — local, staging, production — e quindi le {{variables}}. Tutte le richieste che contiene ereditano l’ambiente selezionato.

La apra, crei un ambiente local e vi aggiunga una variabile:

Chiave	Tipo	Valore
baseUrl	Stringa	https://api.exemple.test

3. Creare e inviare una richiesta

Clic destro sulla cartella ▸ Aggiungi ▸ Richiesta HTTP. Nella scheda che si apre:

• lasciare il metodo su GET;
• inserire l’URL {{baseUrl}}/health — il valore risolto compare sotto il campo, ed è la rete di sicurezza;
• fare clic su Send.

La risposta si apre più in basso: stato, tempo, dimensione, header e il corpo mostrato in un visualizzatore JSON richiudibile.

4. Aggiungere l’autenticazione

Invece di incollare un token in chiaro, conviene creare una richiesta di autenticazione: clic destro ▸ Aggiungi ▸ Richiesta di autenticazione. Configurare la chiamata che ottiene il token (per esempio un POST /oauth/token) e poi, nella sua scheda Configurazione, dichiarare ciò che produce:

Header prodotto	Valore
Authorization	{{token_type}} {{access_token}}

Il valore è un’espressione valutata sul corpo della risposta della richiesta di autenticazione. Conviene indicare anche l’espressione di scadenza (per esempio {{expires_in}}) perché Restorm rinnovi il token da solo.

Tornare sulla richiesta GET e, nella barra superiore, scegliere questa rotta di autenticazione. L’header viene ora iniettato a ogni invio e un 401 innesca automaticamente un rinnovo seguito da un nuovo tentativo.

Dettagli: Autenticazione.

5. Andare oltre

• Ha già una specifica o una collezione? File ▸ Importa (Ctrl+I) ricostruisce l’intero albero: si veda Import & export.
• Concateni più chiamate e verifichi i risultati con uno scenario.
• Faccia girare questo scenario nella propria CI: Esecuzione headless.