API

公開端點

itousouta.me 的公開端點與徽章

GET/feed.xml

雜談的 RSS 2.0 feed，供 RSS 閱讀器訂閱。

curl https://itousouta.me/feed.xml

GET/sitemap.xml

站內所有頁面的 sitemap（含 lastModified）。

curl https://itousouta.me/sitemap.xml

GET/api/search-index

Cmd+K 全站搜尋索引：部落格文章（external URL）＋最近 20 筆雜談。

curl https://itousouta.me/api/search-index

GET/api/vtuber-live

收藏裡所有 VTuber 的開台狀態（VSPO 排程站 + YouTube fallback），60 秒快取。

curl https://itousouta.me/api/vtuber-live

GET/api/now-playing

正在聽的 Spotify 曲目（直打 Spotify API，缺憑證時退回 Lanyard）；沒有在聽時回 null。

curl https://itousouta.me/api/now-playing

GET/api/badge/discord

Discord 狀態徽章（online / idle / do not disturb / offline），貼 README 用。

curl https://itousouta.me/api/badge/discord

GET/api/badge/stars

全部專案的 GitHub 星數加總徽章。

curl https://itousouta.me/api/badge/stars

GET/api/badge/blog

部落格最新一篇標題徽章。

curl https://itousouta.me/api/badge/blog

GET/api/guestbook

留言板列表（最新在前）。

curl https://itousouta.me/api/guestbook

POST/api/guestbook

送出留言，body {nick, text}。回覆另帶 commentId（頂層留言 id）＋parentId（被回覆者 id）；被回覆者有留 email 會寄通知。IP rate limit 5/hr，超過回 429。

curl -X POST https://itousouta.me/api/guestbook -H "Content-Type: application/json" -d '{"nick":"某人","text":"嗨"}'

GET/api/reactions?ids=a,b

雜談按讚計數，ids 用逗號分隔，回 {id: count}。

curl "https://itousouta.me/api/reactions?ids=1,2"

POST/api/reactions

雜談按讚，body {id}。IP rate limit 30/hr，超過回 429。

curl -X POST https://itousouta.me/api/reactions -H "Content-Type: application/json" -d '{"id":"abc"}'

POST/api/revalidate

外部服務（itouBot 發完碎碎念後）觸發 /writing 重新驗證。需 x-revalidate-secret header。

curl -X POST https://itousouta.me/api/revalidate -H "x-revalidate-secret: $REVALIDATE_SECRET"

GUESTBOOK