Merge pull request #3 from sorphwer/feat/add-image-api

feat: add tag api

Author: sorphwer

.cursor/rules/api-rule.mdc

@@ -0,0 +1,6 @@
+---
+description: next.js api design
+alwaysApply: false
+---
+Always follow https://google.aip.dev/general
+CRON API must have authentication.

README.md

@@ -15,3 +15,6 @@
 [![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=sorphwer_dify-helm-watchdog&metric=duplicated_lines_density)](https://sonarcloud.io/summary/new_code?id=sorphwer_dify-helm-watchdog)
 
 [![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=sorphwer_dify-helm-watchdog&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=sorphwer_dify-helm-watchdog)
+
+
+Test CRON： curl -X POST http://localhost:3000/api/v1/cron -H 'secret: SECRET' -v 

dify-helm-watchdog/README.md

@@ -4,12 +4,19 @@ Cyber-dark dashboard that snapshots the [Dify Helm chart](https://langgenius.git
 
 ## Features
 
-- **Daily cron** via `/api/cron` (configured in `vercel.json`) keeps `cache.json`, `values.yaml`, and `docker-images.yaml` files fresh.
+- **Daily cron** via `/api/v1/cron` (configured in `vercel.json`) keeps `cache.json`, `values.yaml`, and `docker-images.yaml` files fresh.
 - **Vercel Blob storage** persists cached artifacts; hashes are tracked in `cache.json` for quick diffing.
 - **Cyber dark UI** with a left-hand version rail and dual copyable code panes powered by a shadcn-inspired `CodeBlock`.
-- **API endpoints**:
-  - `GET /api/cron` – runs the synchronisation job (also accepts POST).
-  - `GET /api/cache` – returns the latest cache payload for lightweight consumers.
+- **RESTful API** for programmatic access:
+  - `GET /api/v1/versions` – list all cached Helm versions
+  - `GET /api/v1/versions/latest` – get latest version info
+  - `GET /api/v1/versions/{version}/images` – get image list (supports JSON/YAML format)
+  - `GET /api/v1/versions/{version}/values` – download values.yaml
+  - `GET /api/v1/versions/{version}/validation` – get image validation results
+  - `POST /api/v1/cron` – runs the synchronisation job
+  - `GET /api/v1/cache` – returns the latest cache payload (legacy endpoint)
+  
+  📖 **[Full API Documentation](./docs/API.md)** | 🚀 **[Quick Start Guide](./docs/QUICKSTART.md)**
 
 ## Prerequisites
 
@@ -38,7 +45,7 @@ Cyber-dark dashboard that snapshots the [Dify Helm chart](https://langgenius.git
 
 4. Prime the cache (optional but recommended before visiting the UI):
    ```bash
-   curl -X POST http://localhost:3000/api/cron
+   curl -X POST http://localhost:3000/api/v1/cron
    ```
    Once complete, the UI at `http://localhost:3000` will show the latest versions and YAML snapshots.
 
@@ -61,7 +68,7 @@ Cyber-dark dashboard that snapshots the [Dify Helm chart](https://langgenius.git
 
 ```
 ┌────────────┐      ┌───────────────────────────┐      ┌─────────────────┐
-│ Vercel Cron│ ---> │ /api/cron (syncHelmData)  │ ---> │ Vercel Blob     │
+│ Vercel Cron│ ---> │ /api/v1/cron (syncHelmData)  │ ---> │ Vercel Blob     │
 └────────────┘      │ - fetch index.yaml        │      │ cache.json       │
                     │ - extract values/images   │      │ values/*.yaml    │
                     └───────────────────────────┘      │ images/*.yaml    │