API surface extracted from NestJS controllers in the central-api service. Use this as a quick map of endpoints, payloads, and permission levels.
http://localhost:3000 (default PORT)
Content type defaults to JSON unless noted.
/meta/combine, /meta/combine_yaml, /redis/:key.
| Permission | Access rule |
|---|---|
| READ_ONLY | Query secret == API_KEY_READ_ONLY OR Authorization: Bearer API_KEY_READ_WRITE |
| READ_WRITE | Authorization: Bearer API_KEY_READ_WRITE |
| AUTH_USER | Session cookie from OAuth login |
| PUBLIC | No auth required. If a session exists, @CurrentUser is populated. |
Health and cached data entry point.
OAuth login, callback, logout, session status.
Run agents and query available tools and models.
Create, update, and delete agent profiles.
Simple link storage endpoints.
Content fetch, article index, webhook.
Subscription aggregation and metadata.
Docker Hub webhook endpoint.
Nav items and migration helpers.
Refresh news sources and read cache.
Search and autocomplete.
Create, update, and like notes.
Key value access and bulk delete.
Scheduled and API task management.
Bond data fetch and proxy endpoints.
| SourceKey | Notes |
|---|---|
| v2ex | V2EX |
| toutiao | Toutiao |
| douyin | Douyin |
| baidu | Baidu |
| hupu | Hupu |
| bilibili | Bilibili |
| zhihu | Zhihu |
| juejin | Juejin |
| itzhijia | Itzhijia |
| linuxdo | Linux.do |
| ifeng | Ifeng |
| idcflare | Idcflare |
| Value | Description |
|---|---|
| FETCH_DATA | Fetch data |
| FETCH_LINUX_DO_TOPIC | Fetch Linux.do topic |
| FETCH_LINUX_DO_NEW_TOPIC_LIST | Fetch Linux.do latest topics |
| UPDATE_LINUX_DO_NAV_ITEM | Update Linux.do nav item |
| UPDATE_LINUX_DO_NAV_ITEM_BATCH | Update Linux.do nav items in batch |
| PUBLISH_NEWS | Publish news to GitHub |
| RUN_AGENT | Run AI agent |
| GET_NEWS_TOP | Get news top list |
| RENEW_CURRENT_DATE | Renew current date |
| MESSAGE_PROVIDER | Parameterized message provider |
| SAVE_LINUX_DO_NOTE | Save Linux.do note |
| SAVE_LINUX_DO_NOTE_BATCH | Save Linux.do notes in batch |