【少女人妻的30天Elastic】Day 30 : App Search_API 介绍与应用_Synonyms

Aloha！我是少女人妻 Uerica！这篇是最後一篇了，虽然没有写到很深，但对搜寻引擎真的有多了一层很深的认识，三十天来也算进步很多吧？哈哈。当然我跟老公感情也更好拉～（笑），然後也感谢看我文章的各位！看到浏览人数也是我动力来源之一，本人只是个默默在厨房经营小世界还有接接案的人妻一枚，能够有机会给点产出也是满开心搭～

工商时间
想认识深深的 ElasticSearch 可以去看乔叔带你上手Elastic Stack系列

另外乔叔还有开课喔！请洽 [email protected]

想运用 ElasticSearch 做分析台股跟程序交易可以去看 Elastic 战台股系列

Synonyms API 同义词

最後就跟大家聊一下 Synonyms 的 API 运用方法吧～，可以先去看这篇Elastic App Search_搜寻优化_趴万了解一下 Synonyms 的设定与用法

认证方式

curl -X GET '{API_Endpoint}/api/as/v1/engines/{ENGINE_NAME}/synonyms' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxx' \

List Synonyms 列出同义词 GET

List All Sets of Synonyms

列出所有同义词

page (optional) : 回传当前页面 current 、结果总页数 total_pages 、结果总笔数 total_results 、每页最大笔数限制 size （预设为25笔）

用GET，不带参数

curl -X GET '{API_Endpoint}/api/as/v1/engines/{ENGINE_NAME}/synonyms' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxx' \
-d ''

Listing All Synonyms with Pagination

指定回传的页数与笔数

curl -X GET '{API_Endpoint}/api/as/v1/engines/{ENGINE_NAME}/synonyms' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxx' \
-d '{
  "page": {
    "size": 20,
    "current": 2
  }
}'

Listing a Single synonyms

回传指定id的策展资料

用 GET 方法，带入id不需参数，回传指定的策展资料

curl -X GET '{API_Endpoint}/api/as/v1/engines/{ENGINE_NAME}/synonyms/[SYNONYM_SET_ID]' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxx' \
-d ''

Create a Synonyms Set 创建同义词集 POST

为 engine 创建新的同义词集，每个 API call 只能创建一组同义词集，同义词集最多可包含32个单词

用 POST 创建同义词集

curl -X POST '{API_Endpoint}/api/as/v1/engines/{ENGINE_NAME}/synonyms' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxx' \
-d '{
  "synonyms": ["park", "trail"]
}'

范例回传结果

{
  "id": "syn-5b11ac72c9f9296b35220ac9",
  "synonyms": [
    "park",
    "trail"
  ]
}

Update a Synonyms Set 更新同义词集 PUT

synonyms (required) : 至少包含两个同义字词

用 PUT 更新同义词集

curl -X PUT '{API_Endpoint}/api/as/v1/engines/{ENGINE_NAME}/synonyms/[SYNONYM_SET_ID]' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxx' \
-d '{
  "synonyms": ["road", "trail"]
}'

Delete a synonyms 删除同义字词 DELETE

用 DELETE 删除指定id的同义字词

curl -X DELETE '{API_Endpoint}/api/as/v1/engines/{ENGINE_NAME}/synonyms/[SYNONYM_SET_ID]' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxx' \
-d ''