Быстрый старт API

Предварительные условия:

• Базовые навыки работы с терминалом/командной строкой
• caddy и curl в вашей PATH

Сначала запустите Caddy:

caddy start

Caddy в настоящее время работает в режиме ожидания (с пустой конфигурацией). Дайте ему простую конфигурацию с помощью curl:

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

Использование POST-тела с Heredoc может быть утомительным, поэтому если вы предпочитаете использовать файлы, сохраните JSON в файл под названием caddy.json, а затем используйте эту команду вместо этого:

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

Теперь загрузите localhost:2015 в вашем браузере или используйте curl:

curl localhost:2015
Hello, world!

Мы также можем определить несколько сайтов на разных интерфейсах с помощью этого JSON:

{
	"apps": {
		"http": {
			"servers": {
				"hello": {
					"listen": [":2015"],
					"routes": [
						{
							"handle": [{
								"handler": "static_response",
								"body": "Hello, world!"
							}]
						}
					]
				},
				"bye": {
					"listen": [":2016"],
					"routes": [
						{
							"handle": [{
								"handler": "static_response",
								"body": "Goodbye, world!"
							}]
						}
					]
				}
			}
		}
	}
}

Обновите ваш JSON, затем выполните запрос API снова.

Попробуйте новый конечный пункт "goodbye" в вашем браузере или с помощью curl, чтобы убедиться, что он работает:

curl localhost:2016
Goodbye, world!

Когда вы закончите работу с Caddy, убедитесь, что вы его остановили:

caddy stop

Вы можете сделать гораздо больше с API, включая экспорт конфигурации и внесение тонких изменений в конфигурацию (в отличие от обновления всего). Обязательно прочитайте полный учебник по API, чтобы узнать как!

Дополнительное чтение

• Полный учебник по API
• Документация по API