Add openapi spec

.github/workflows/main.yml

@@ -47,6 +47,9 @@ jobs:
       - name: Lint code
         run: make lint
 
+      - name: Check docs
+        run: make docs
+
       - name: Run unit tests
         env:
           TEST_SCHEMA_URI: "./etc/ecs-8.2.0.tar.gz"

.license_ignore

@@ -15,6 +15,8 @@ requirements.txt
 runtime.txt
 setup.cfg
 
+docs/api-spec.html
+
 scripts/generate-alerts.sh
 scripts/generate-network-events.sh
 

Makefile

@@ -18,6 +18,8 @@ define embed-python
 endef
 endif
 
+REDOCLY := npx -y @redocly/cli
+
 rwildcard=$(foreach d,$(wildcard $(1:=/*)),$(call rwildcard,$d,$2) $(filter $(subst *,%,$2),$d))
 
 all: lint tests
@@ -32,6 +34,7 @@ prereq-go: prereq-py
 lint:
 	$(PYTHON) -m black -q --check geneve tests || ($(PYTHON) -m black geneve tests; false)
 	$(PYTHON) -m isort -q --check geneve tests || ($(PYTHON) -m isort geneve tests; false)
+	$(REDOCLY) lint docs/api-spec.yaml
 
 license-check:
 	bash scripts/license_check.sh
@@ -92,6 +95,11 @@ package: pkg-build
 	$(MAKE) pkg-install VENV=$(VENV)
 	rm -rf $(VENV)
 
+docs/api-spec.html: docs/api-spec.yaml
+	$(REDOCLY) build-docs --output $@ $<
+
+docs: docs/api-spec.html
+
 CREDS_FILE=credentials-cloud-stack.json
 
 cloud-stack-up:
@@ -135,4 +143,4 @@ override TEST_STACK_VERSION := $(shell \
 )
 endif
 
-.PHONY: lint tests online_tests run up down
+.PHONY: docs lint tests online_tests run up down

cmd/internal/utils/endpoint.go

@@ -34,7 +34,7 @@ func DecodeRequestBody(w http.ResponseWriter, req *http.Request, data any, known
 	}
 
 	switch content_type[0] {
-	case "application/yaml":
+	case "application/yaml", "text/yaml":
 		dec := yaml.NewDecoder(req.Body)
 		dec.KnownFields(knownFields)
 		err := dec.Decode(data)