註冊

瀏覽與分類

分面瀏覽、48 個語義分類

01browse 與 search 的分工

/browse/search
定位分面瀏覽:給人挑選精確檢索:給程式收窄
聲調只接受絕對碼 code碼、相對走向、音近排序皆可
排序全域熱度,穩定可依音近／字元／相似度重排
深層分頁適合適合
速率(匿名)150 / 分鐘60 / 分鐘

/browse 的參數是 /search 的子集,交換到的是更高的速率上限與更穩定的排序 —— 做「分類 → 情緒 → 字數」這種逐層收窄的介面時用它。

02分面瀏覽

GET/api/lexicon/browse
參數型別預設說明
rhymestring—韻母本身,例如 am。(注意:此處傳韻母,不是參考字)
codestring—絕對協音碼。
emotionstring—情緒。
themestring—主題意象。
theme_scopestringtaggedtagged / all / inferred。
valencestring—正 / 負 / 中。
categorystring—語義分類 lexname。
regstring—語域:粵 / 通 / 雅。
posstring—詞性:n / v / a / r。
lengthinteger—字數。
limitinteger50每頁筆數,上限依方案。
offsetinteger0位移。
押 am 韻 × 悲傷 × 兩字
cURL
curl -H "Authorization: Bearer $WRITERHK_API_KEY" \
  "https://api.writer.hk/api/lexicon/browse?rhyme=am&emotion=悲傷&length=2&limit=6"
↳total 82 · 下沉 / 不堪 / 低吟 / 低沉 / 低陷 / 傷心
粵語口語動詞
cURL
curl -H "Authorization: Bearer $WRITERHK_API_KEY" \
  "https://api.writer.hk/api/lexicon/browse?reg=粵&pos=v&length=2&limit=6"
↳total 808 · 上報 / 上枱 / 上癮 / 上貨 / 上香 / 下坡
rhyme 對 rhyme_char
/browse 收韻母(rhyme=am),/search 收參考字(rhyme_char=心)。傳錯會得到零結果而非錯誤 —— 這是兩者最常見的混淆點。

0348 個語義分類

GET/api/lexicon/categories

分類採 WordNet lexname 體系,共 48 個,並附中文標籤與詞條數。此端點無參數。

回應（節錄）
{
  "categories": [
    { "name": "adj.all",        "label": "形容詞",   "pos": "a", "words": 24736 },
    { "name": "noun.artifact",  "label": "人造物",   "pos": "n", "words": 16652 },
    { "name": "verb.motion",    "label": "移動",     "pos": "v", "words": 11372 },
    { "name": "noun.plant",     "label": "植物",     "pos": "n", "words": 6010 }
  ]
}

介面上請顯示中文 label,但同時保留 name —— 開發者需要看到自己實際會傳的值。

分類層的可信度
分類覆蓋大量詞條,其中相當比例是由模型生成的語義群推導而來,並非全部經人工核對。 用於給人挑選沒有問題;用於自動化判斷前,請先讀資料品質申報。

04分類取詞

GET/api/lexicon/category/{name}/words

等同 /search?category=…,但把分類放進路徑,便於做 REST 風格的分類頁。 可再疊加 rhyme_char、code、emotion、valence、theme、reg、pos、length、quality。

情感類 × 負面 × 兩字
cURL
curl -H "Authorization: Bearer $WRITERHK_API_KEY" \
  "https://api.writer.hk/api/lexicon/category/noun.feeling/words?valence=負&length=2&limit=6"
↳total 518 · 不仁 / 不和 / 不安 / 不屑 / 不幸 / 不敬

05取得全部合法值

GET/api/lexicon/vocabulary

一次取得 emotion、theme、valence 的全部合法值及其詞條數。 建議在應用啟動時取一次並快取 —— 硬寫死清單會在資料更新後失準。

回應（節錄）
{
  "emotion": { "中性": 97536, "喜悅": 7132, "悲傷": 4830, "愛慕": 366 },
  "theme":   { "自然": 4827, "時間": 2681, "傷痛": 2517, "希望": 2466 },
  "theme_inferred": { },
  "theme_coverage": { }
}

theme_inferred 與 theme_coverage 對應theme_scope=inferred 的範圍,可用來判斷某個主題值得不值得放寬。

06同音字與自動完成

GET/api/lexicon/homophones/{char}
cURL
curl -H "Authorization: Bearer $WRITERHK_API_KEY" \
  "https://api.writer.hk/api/lexicon/homophones/心"
↳sam1 → 9 個同音字；san1 → 16 個
多音字會逐個讀音分組,每組附該讀音下的同音字與釋義。
GET/api/lexicon/autocomplete
cURL
curl -H "Authorization: Bearer $WRITERHK_API_KEY" \
  "https://api.writer.hk/api/lexicon/autocomplete?prefix=孤&limit=8"
↳孤 / 孤丁 / 孤丁丁 / 孤仔 / 孤件 / 孤伶伶 / 孤例 / 孤傲
字首補全,回應只有字串陣列,適合直接接輸入框。 此端點同樣計入配額 —— 它是枚舉詞庫最便宜的路徑,不設限就等於開了後門。
  • 做輸入框建議時請設 debounce;匿名速率為 60 / 分鐘,Free 密鑰亦為 60 / 分鐘。
  • 只需要自動完成的前端,可簽發 scopes=lex_ac 的專用密鑰。