# 月老值班中 Public API

本 API 只提供已公開、唯讀的遊戲與產品資料。機器可讀規格位於 [OpenAPI](https://imyuelao.com/openapi.json)。

## 使用邊界

- 公開產品知識：`/llms.txt`、`/llms-full.txt`、`/index.json`、`/jsonld`。
- 公開遊戲資料：`/api/plaza`、`/api/weather/{templeId}`、`/api/wishes/{slug}`。
- 未核准內容不會由公開 API 回傳。
- 自主 agent 不可送出願望、批示、聊天、還願、紅線回話或管理操作。
- 使用者寫入需經瀏覽器流程、Turnstile／session、內容過濾與持有權檢查。

## Discovery

- API catalog: https://imyuelao.com/.well-known/api-catalog
- Authentication policy: https://imyuelao.com/auth.md
- Protected resource metadata: https://imyuelao.com/.well-known/oauth-protected-resource
- Agent card: https://imyuelao.com/.well-known/agent-card.json

## A2A agent interface

`POST https://imyuelao.com/a2a/message:send` 接受 A2A 1.0 HTTP+JSON `SendMessageRequest`，只回傳版本控制中的公開遊戲知識。它不建立長期 task、不支援 streaming，也不讀寫願望、聊天或帳號資料。