Synonyms
Synonyms and mined suggestions.
10 نقاط وصول. أسماء نقاط الوصول وأوصافها مأخوذة من ملف OpenAPI، لذلك تظهر بالإنجليزية.
GET /v1/synonyms/suggestionsGET /v1/synonyms/suggestions/statusPOST /v1/synonyms/suggestions/{suggestion_id}/decisionGET /v1/synonymsPOST /v1/synonymsGET /v1/synonyms/exportPOST /v1/synonyms/importGET /v1/synonyms/{synonym_id}PUT /v1/synonyms/{synonym_id}DELETE /v1/synonyms/{synonym_id}
GET
/v1/synonyms/suggestionsSynonyms mined from zero-result queries and reformulations
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
status | query | "pending" | "approved" | "rejected" | لا | default "pending" |
cursor | query | string | null | لا | max length 200 |
limit | query | integer | لا | default 50 · min 1 · max 200 |
الردود
- 200Successful Response
Page_SynonymSuggestionOut_
GET
/v1/synonyms/suggestions/statusWhen suggestions are made next and what they need
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
الردود
- 200Successful Response
SynonymMiningStatus
POST
/v1/synonyms/suggestions/{suggestion_id}/decisionApprove (one click) or reject a suggestion
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
suggestion_id | path | string | نعم |
جسم الطلب application/json SuggestionDecision
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
decision | "approve" | "reject" | نعم |
الردود
- 200Successful Response
SynonymSuggestionOut
GET
/v1/synonymsList synonyms
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
cursor | query | string | null | لا | max length 200 |
limit | query | integer | لا | default 100 · min 1 · max 200 |
q | query | string | null | لا | max length 100 |
الردود
- 200Successful Response
Page_SynonymOut_
POST
/v1/synonymsSynonyms Create
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
Idempotency-Key | header | string | null | لا | Unique per logical write (8-255 chars). Retries with the same key are safe. · pattern ^[A-Za-z0-9_\-:.]{8,255}$ |
جسم الطلب application/json SynonymIn
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
kind | "equivalent" | "one_way" | نعم | |
terms | string[] | لا | equivalent: all match each other. |
input | string | null | لا | one_way: this word...max length 200 |
outputs | string[] | لا | ...also searches these. |
conditions | SynonymConditions | null | لا | |
locale | string | null | لا | pattern ^[a-z]{2}$ |
set_key | string | لا | Named set (see RankingConfig).default "default" · pattern ^[a-z0-9][a-z0-9_-]{0,31}$ |
enabled | boolean | لا | default true |
الردود
- 201Successful Response
SynonymOut
GET
/v1/synonyms/exportExport synonyms
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
format | query | "json" | "csv" | "solr" | لا | default "json" |
الردود
- 200Successful Response
string
POST
/v1/synonyms/importSynonyms Import
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
Idempotency-Key | header | string | null | لا | Unique per logical write (8-255 chars). Retries with the same key are safe. · pattern ^[A-Za-z0-9_\-:.]{8,255}$ |
جسم الطلب application/json SynonymImport
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
format | "json" | "csv" | "solr" | لا | default "json" |
content | string | نعم | The file content.max length 2000000 |
mode | "merge" | "replace" | لا | default "merge" |
الردود
- 200Successful Response
SynonymImportResult
GET
/v1/synonyms/{synonym_id}Synonyms Get
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
synonym_id | path | string | نعم |
الردود
- 200Successful Response
SynonymOut
PUT
/v1/synonyms/{synonym_id}Synonyms Update
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
synonym_id | path | string | نعم |
جسم الطلب application/json SynonymIn
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
kind | "equivalent" | "one_way" | نعم | |
terms | string[] | لا | equivalent: all match each other. |
input | string | null | لا | one_way: this word...max length 200 |
outputs | string[] | لا | ...also searches these. |
conditions | SynonymConditions | null | لا | |
locale | string | null | لا | pattern ^[a-z]{2}$ |
set_key | string | لا | Named set (see RankingConfig).default "default" · pattern ^[a-z0-9][a-z0-9_-]{0,31}$ |
enabled | boolean | لا | default true |
الردود
- 200Successful Response
SynonymOut
DELETE
/v1/synonyms/{synonym_id}Synonyms Delete
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
synonym_id | path | string | نعم |
الردود
- 200Successful Response
Deleted
أشكال البيانات في هذه الصفحة
Page_SynonymSuggestionOut_
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
data | SynonymSuggestionOut[] | نعم | |
next_cursor | string | null | لا | |
total | integer | null | لا | Present when cheap to count. |
SynonymSuggestionOut
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
id | string | نعم | |
kind | "equivalent" | "one_way" | نعم | |
terms | string[] | لا | |
input | string | null | لا | |
outputs | string[] | لا | |
evidence | object | لا | Queries and counts that led to it. |
score | number | نعم | |
status | "pending" | "approved" | "rejected" | نعم | |
created_at | string (date-time) | نعم | |
labels | map<string, string> | لا | Term (input, outputs, terms) -> the spelling shoppers typed most often, for display. Only terms whose typed spelling differs (e.g. "شنطه" -> "شنطة"); show any other term as it is. |
SynonymMiningStatus
When synonym suggestions are made and what they need (GET /v1/synonyms/suggestions/status). A nightly job mines the store's own searches; a zero-result query becomes a suggestion only when shoppers in at least `min_sessions` different sessions searched it.
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
schedule | string | نعم | Plain text, e.g. "daily at 03:00 UTC". |
next_run_at | string (date-time) | نعم | |
last_run_at | string (date-time) | null | لا | End of the last run, for every store. |
window_days | integer | نعم | Searches of the last N days are used. |
min_sessions | integer | نعم | Different shopper sessions a query needs. |
zero_result_queries | integer | نعم | Different zero-result queries in the window. |
queries_ready | integer | نعم | Zero-result queries with enough sessions for the next run. |
searches_without_session | integer | نعم | Zero-result searches sent without a session id (widget `session`, API `session`): never used. |
SuggestionDecision
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
decision | "approve" | "reject" | نعم |
Page_SynonymOut_
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
data | SynonymOut[] | نعم | |
next_cursor | string | null | لا | |
total | integer | null | لا | Present when cheap to count. |
SynonymOut
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
kind | "equivalent" | "one_way" | نعم | |
terms | string[] | لا | equivalent: all match each other. |
input | string | null | لا | one_way: this word...max length 200 |
outputs | string[] | لا | ...also searches these. |
conditions | SynonymConditions | null | لا | |
locale | string | null | لا | pattern ^[a-z]{2}$ |
set_key | string | لا | Named set (see RankingConfig).default "default" · pattern ^[a-z0-9][a-z0-9_-]{0,31}$ |
enabled | boolean | لا | default true |
id | string | نعم | |
source | "manual" | "import" | "suggested" | "global_copy" | لا | default "manual" |
created_at | string (date-time) | نعم | |
updated_at | string (date-time) | نعم |
SynonymConditions
one_way only. Expand `input` -> `outputs` only when the normalized query passes these checks. Example: dress -> gown, maxi... with unless_terms [bag, hanger, pattern].
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
unless_terms | string[] | لا | Skip if any of these is present. |
require_terms | string[] | لا | Apply only if all are present. |
SynonymIn
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
kind | "equivalent" | "one_way" | نعم | |
terms | string[] | لا | equivalent: all match each other. |
input | string | null | لا | one_way: this word...max length 200 |
outputs | string[] | لا | ...also searches these. |
conditions | SynonymConditions | null | لا | |
locale | string | null | لا | pattern ^[a-z]{2}$ |
set_key | string | لا | Named set (see RankingConfig).default "default" · pattern ^[a-z0-9][a-z0-9_-]{0,31}$ |
enabled | boolean | لا | default true |
SynonymImport
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
format | "json" | "csv" | "solr" | لا | default "json" |
content | string | نعم | The file content.max length 2000000 |
mode | "merge" | "replace" | لا | default "merge" |
SynonymImportResult
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
created | integer | نعم | |
updated | integer | نعم | |
skipped | integer | نعم | |
errors | string[] | لا |
Deleted
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
deleted | boolean | لا | default true |
id | string | نعم |