Avvio rapido all'API

Prerequisiti:

Competenze di base del terminale / riga di comando
caddy e curl nel vostro PATH

Per prima cosa, avviate Caddy:

caddy start

Caddy è attualmente in esecuzione a riposo (con una configurazione vuota). Fornitegli una semplice configurazione con curl:

curl localhost:2019/load \
    -H "Content-Type: application/json" \
    -d @- << EOF
    {
        "apps": {
            "http": {
                "servers": {
                    "hello": {
                        "listen": [":2015"],
                        "routes": [
                            {
                                "handle": [{
                                    "handler": "static_response",
                                    "body": "Ciao, mondo!"
                                }]
                            }
                        ]
                    }
                }
            }
        }
    }
EOF

Fornire un corpo POST con un Heredoc può essere noioso, quindi se preferite usare i file, salvate il JSON in un file chiamato caddy.json e poi usate invece questo comando:

curl localhost:2019/load \
  -H "Content-Type: application/json" \
  -d @caddy.json

Ora caricate localhost:2015 nel vostro browser o usate curl:

curl localhost:2015
Ciao, mondo!

Possiamo anche definire più siti su interfacce diverse con questo JSON:

{
	"apps": {
		"http": {
			"servers": {
				"hello": {
					"listen": [":2015"],
					"routes": [
						{
							"handle": [{
								"handler": "static_response",
								"body": "Ciao, mondo!"
							}]
						}
					]
				},
				"bye": {
					"listen": [":2016"],
					"routes": [
						{
							"handle": [{
								"handler": "static_response",
								"body": "Arrivederci, mondo!"
							}]
						}
					]
				}
			}
		}
	}
}

Aggiornate il vostro JSON e poi eseguite nuovamente la richiesta API.

Provate il vostro nuovo endpoint "arrivederci" nel vostro browser o con curl per assicurarvi che funzioni:

curl localhost:2016
Arrivederci, mondo!

Quando avrete finito con Caddy, assicuratevi di fermarlo:

caddy stop

C'è molto altro che potete fare con l'API, inclusa l'esportazione della configurazione e l'apporto di modifiche granulari alla configurazione (anziché aggiornare l'intero documento). Assicuratevi di leggere il tutorial completo sull'API per imparare come fare!

Avvio rapido all'API

Letture consigliate