initial commit

Change-Id: I35f00d25ebe8c71518adecf99aa11ac9fcad0671

docs/api.md

@@ -0,0 +1,20 @@
+# API Reference
+
+Base URL: `https://cicd-deep-link-test.kyndemo.live`
+
+## Items `/api/items`
+
+| Method | Path | Body | Response |
+|--------|------|------|----------|
+| GET | `/api/items` | — | Array of items |
+| POST | `/api/items` | `{"name":"...","description":"..."}` | Created item (201) |
+| GET | `/api/items/{id}` | — | Item or 404 |
+| PUT | `/api/items/{id}` | `{"name":"...","description":"..."}` | Updated item |
+| DELETE | `/api/items/{id}` | — | `{"deleted":id}` |
+
+## Observability
+
+| Path | Description |
+|------|-------------|
+| `/actuator/health` | Health check — `{"status":"UP"}` |
+| `/metrics` | Prometheus exposition format |