HTTP API

Runtime 只实现 HTTP/1.1 明文服务。生产环境必须通过 Nginx/Caddy/HAProxy 终止 TLS。

启动

./zava.elf --name API --data-dir ./api-data --http-host 127.0.0.1 --http-port 8080

端点

方法	路径	成功码	作用
GET	/health	200	存活与品牌标识
GET	/status	200	Runtime 状态
POST	/chat	200	JSON 消息到回复
GET/POST	/memory	200/201	查看或追加记忆
GET	/skill	200	技能状态
POST	/dream	201	触发一次演化
GET	/ws	101	WebSocket 升级

示例

curl -i http://127.0.0.1:8080/health

{"status":"ok","runtime":"Zava"}

curl -s -X POST http://127.0.0.1:8080/chat \
  -H "Content-Type: application/json" \
  -d '{"message":"你好"}'

{"reply":"I received: 你好"}

请求路径必须精确匹配；未知路径返回 404，方法错误返回 405，畸形请求返回 400， 超过请求上限返回 413。服务器禁止目录映射，因此 URL 路径不会映射到文件系统。