@algolia/n8n-nodes-algolia 0.6.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -55
- package/dist/nodes/Algolia/Algolia.node.js +1918 -1996
- package/dist/nodes/Algolia/specs/abtesting-v3.json +43 -155
- package/dist/nodes/Algolia/specs/abtesting.json +35 -122
- package/dist/nodes/Algolia/specs/advanced-personalization.json +64 -238
- package/dist/nodes/Algolia/specs/analytics.json +107 -366
- package/dist/nodes/Algolia/specs/composition.json +237 -716
- package/dist/nodes/Algolia/specs/crawler.json +181 -536
- package/dist/nodes/Algolia/specs/ingestion.json +245 -992
- package/dist/nodes/Algolia/specs/insights.json +56 -222
- package/dist/nodes/Algolia/specs/monitoring.json +17 -57
- package/dist/nodes/Algolia/specs/personalization.json +24 -74
- package/dist/nodes/Algolia/specs/query-suggestions.json +26 -79
- package/dist/nodes/Algolia/specs/recommend.json +219 -688
- package/dist/nodes/Algolia/specs/search.json +459 -1428
- package/package.json +1 -1
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"openapi": "3.0.2",
|
|
3
3
|
"info": {
|
|
4
4
|
"title": "Composition API",
|
|
5
|
-
"description": "The Algolia Composition API lets you run composed search requests on your Compositions.\n\n## Client libraries\n\nUse Algolia's API clients and libraries to reliably integrate Algolia's APIs with your apps.\n\nSee: [Algolia's ecosystem](https://www.algolia.com/doc/guides/getting-started/how-algolia-works/in-depth/ecosystem
|
|
5
|
+
"description": "The Algolia Composition API lets you run composed search requests on your Compositions.\n\n## Client libraries\n\nUse Algolia's API clients and libraries to reliably integrate Algolia's APIs with your apps.\n\nSee: [Algolia's ecosystem](https://www.algolia.com/doc/guides/getting-started/how-algolia-works/in-depth/ecosystem)\n\n## Base URLs\n\nThe base URLs for requests to the Composition API are:\n\n- `https://{APPLICATION_ID}.algolia.net`\n- `https://{APPLICATION_ID}-dsn.algolia.net`.\n If your subscription includes a [Distributed Search Network](https://dashboard.algolia.com/infra),\n this ensures that requests are sent to servers closest to users.\n\nBoth URLs provide high availability by distributing requests with load balancing.\n\n**All requests must use HTTPS.**\n\n## Retry strategy\n\nTo guarantee high availability, implement a retry strategy for all API requests using the URLs of your servers as fallbacks:\n\n- `https://{APPLICATION_ID}-1.algolianet.com`\n- `https://{APPLICATION_ID}-2.algolianet.com`\n- `https://{APPLICATION_ID}-3.algolianet.com`\n\nThese URLs use a different DNS provider than the primary URLs.\nYou should randomize this list to ensure an even load across the three servers.\n\nAll Algolia API clients implement this retry strategy.\n\n## Authentication\n\nTo authenticate your API requests, add these headers:\n\n- `x-algolia-application-id`. Your Algolia application ID.\n- `x-algolia-api-key`. An API key with the necessary permissions to make the request.\n The required access control list (ACL) to make a request is listed in each endpoint's reference.\n\nYou can find your application ID and API key in the [Algolia dashboard](https://dashboard.algolia.com/account).\n\n## Request format\n\nDepending on the endpoint, request bodies are either JSON objects or arrays of JSON objects,\n\n## Parameters\n\nParameters are passed in the request body for POST and PUT requests.\nQuery parameters must be [URL-encoded](https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding).\nNon-ASCII characters must be UTF-8 encoded.\nPlus characters (`+`) are interpreted as spaces.\n\n## Response status and errors\n\nThe Composition API returns JSON responses.\nSince JSON doesn't guarantee any specific ordering, don't rely on the order of attributes in the API response.\n\nSuccessful responses return a `2xx` status. Client errors return a `4xx` status. Server errors are indicated by a `5xx` status.\nError responses have a `message` property with more information.\n\n## Version\n\nThe current version of the Composition API is version 1, as indicated by the `/1/` in each endpoint's URL.\n",
|
|
6
6
|
"version": "1.0.0"
|
|
7
7
|
},
|
|
8
8
|
"servers": [
|
|
@@ -244,15 +244,11 @@
|
|
|
244
244
|
},
|
|
245
245
|
"/1/compositions/{compositionID}/run": {
|
|
246
246
|
"post": {
|
|
247
|
-
"tags": [
|
|
248
|
-
"Search"
|
|
249
|
-
],
|
|
247
|
+
"tags": ["Search"],
|
|
250
248
|
"operationId": "search",
|
|
251
249
|
"x-use-read-transporter": true,
|
|
252
250
|
"x-cacheable": true,
|
|
253
|
-
"x-acl": [
|
|
254
|
-
"search"
|
|
255
|
-
],
|
|
251
|
+
"x-acl": ["search"],
|
|
256
252
|
"summary": "Run a Composition",
|
|
257
253
|
"description": "Runs a query on a single composition and returns matching results.",
|
|
258
254
|
"parameters": [
|
|
@@ -305,15 +301,11 @@
|
|
|
305
301
|
},
|
|
306
302
|
"/1/compositions/{compositionID}/facets/{facetName}/query": {
|
|
307
303
|
"post": {
|
|
308
|
-
"tags": [
|
|
309
|
-
"Search"
|
|
310
|
-
],
|
|
304
|
+
"tags": ["Search"],
|
|
311
305
|
"operationId": "searchForFacetValues",
|
|
312
306
|
"x-use-read-transporter": true,
|
|
313
307
|
"x-cacheable": true,
|
|
314
|
-
"x-acl": [
|
|
315
|
-
"search"
|
|
316
|
-
],
|
|
308
|
+
"x-acl": ["search"],
|
|
317
309
|
"summary": "Search for facet values",
|
|
318
310
|
"description": "Searches for values of a specified facet attribute on the composition's main source's index.\n\n- By default, facet values are sorted by decreasing count.\n You can adjust this with the `sortFacetValueBy` parameter.\n- Searching for facet values doesn't work if you have **more than 65 searchable facets and searchable attributes combined**.\n",
|
|
319
311
|
"parameters": [
|
|
@@ -386,14 +378,9 @@
|
|
|
386
378
|
},
|
|
387
379
|
"/1/compositions": {
|
|
388
380
|
"get": {
|
|
389
|
-
"tags": [
|
|
390
|
-
"Compositions"
|
|
391
|
-
],
|
|
381
|
+
"tags": ["Compositions"],
|
|
392
382
|
"operationId": "listCompositions",
|
|
393
|
-
"x-acl": [
|
|
394
|
-
"editSettings",
|
|
395
|
-
"settings"
|
|
396
|
-
],
|
|
383
|
+
"x-acl": ["editSettings", "settings"],
|
|
397
384
|
"summary": "List compositions",
|
|
398
385
|
"description": "Lists all compositions in the current Algolia application.\n",
|
|
399
386
|
"parameters": [
|
|
@@ -432,14 +419,9 @@
|
|
|
432
419
|
},
|
|
433
420
|
"/1/compositions/{compositionID}": {
|
|
434
421
|
"get": {
|
|
435
|
-
"tags": [
|
|
436
|
-
"Compositions"
|
|
437
|
-
],
|
|
422
|
+
"tags": ["Compositions"],
|
|
438
423
|
"operationId": "getComposition",
|
|
439
|
-
"x-acl": [
|
|
440
|
-
"editSettings",
|
|
441
|
-
"settings"
|
|
442
|
-
],
|
|
424
|
+
"x-acl": ["editSettings", "settings"],
|
|
443
425
|
"summary": "Retrieve a composition",
|
|
444
426
|
"description": "Retrieve a single composition in the current Algolia application.\n",
|
|
445
427
|
"parameters": [
|
|
@@ -473,13 +455,9 @@
|
|
|
473
455
|
}
|
|
474
456
|
},
|
|
475
457
|
"put": {
|
|
476
|
-
"tags": [
|
|
477
|
-
"Compositions"
|
|
478
|
-
],
|
|
458
|
+
"tags": ["Compositions"],
|
|
479
459
|
"operationId": "putComposition",
|
|
480
|
-
"x-acl": [
|
|
481
|
-
"editSettings"
|
|
482
|
-
],
|
|
460
|
+
"x-acl": ["editSettings"],
|
|
483
461
|
"summary": "Upsert a composition",
|
|
484
462
|
"description": "Upsert a composition in the current Algolia application.\n",
|
|
485
463
|
"parameters": [
|
|
@@ -511,9 +489,7 @@
|
|
|
511
489
|
"$ref": "#/components/schemas/taskID"
|
|
512
490
|
}
|
|
513
491
|
},
|
|
514
|
-
"required": [
|
|
515
|
-
"taskID"
|
|
516
|
-
]
|
|
492
|
+
"required": ["taskID"]
|
|
517
493
|
}
|
|
518
494
|
}
|
|
519
495
|
}
|
|
@@ -533,13 +509,9 @@
|
|
|
533
509
|
}
|
|
534
510
|
},
|
|
535
511
|
"delete": {
|
|
536
|
-
"tags": [
|
|
537
|
-
"Compositions"
|
|
538
|
-
],
|
|
512
|
+
"tags": ["Compositions"],
|
|
539
513
|
"operationId": "deleteComposition",
|
|
540
|
-
"x-acl": [
|
|
541
|
-
"editSettings"
|
|
542
|
-
],
|
|
514
|
+
"x-acl": ["editSettings"],
|
|
543
515
|
"summary": "Delete a composition",
|
|
544
516
|
"description": "Delete a composition from the current Algolia application.\n",
|
|
545
517
|
"parameters": [
|
|
@@ -561,9 +533,7 @@
|
|
|
561
533
|
"$ref": "#/components/schemas/taskID"
|
|
562
534
|
}
|
|
563
535
|
},
|
|
564
|
-
"required": [
|
|
565
|
-
"taskID"
|
|
566
|
-
]
|
|
536
|
+
"required": ["taskID"]
|
|
567
537
|
}
|
|
568
538
|
}
|
|
569
539
|
}
|
|
@@ -582,14 +552,10 @@
|
|
|
582
552
|
},
|
|
583
553
|
"/1/compositions/*/batch": {
|
|
584
554
|
"post": {
|
|
585
|
-
"tags": [
|
|
586
|
-
"Compositions"
|
|
587
|
-
],
|
|
555
|
+
"tags": ["Compositions"],
|
|
588
556
|
"operationId": "multipleBatch",
|
|
589
557
|
"description": "Adds, updates, or deletes compositions with a single API request.\n",
|
|
590
|
-
"x-acl": [
|
|
591
|
-
"editSettings"
|
|
592
|
-
],
|
|
558
|
+
"x-acl": ["editSettings"],
|
|
593
559
|
"summary": "Batch action to multiple compositions",
|
|
594
560
|
"requestBody": {
|
|
595
561
|
"required": true,
|
|
@@ -615,16 +581,11 @@
|
|
|
615
581
|
"$ref": "#/components/schemas/batchCompositionAction"
|
|
616
582
|
}
|
|
617
583
|
},
|
|
618
|
-
"required": [
|
|
619
|
-
"action",
|
|
620
|
-
"body"
|
|
621
|
-
]
|
|
584
|
+
"required": ["action", "body"]
|
|
622
585
|
}
|
|
623
586
|
}
|
|
624
587
|
},
|
|
625
|
-
"required": [
|
|
626
|
-
"requests"
|
|
627
|
-
]
|
|
588
|
+
"required": ["requests"]
|
|
628
589
|
}
|
|
629
590
|
}
|
|
630
591
|
}
|
|
@@ -647,9 +608,7 @@
|
|
|
647
608
|
}
|
|
648
609
|
}
|
|
649
610
|
},
|
|
650
|
-
"required": [
|
|
651
|
-
"taskID"
|
|
652
|
-
]
|
|
611
|
+
"required": ["taskID"]
|
|
653
612
|
}
|
|
654
613
|
}
|
|
655
614
|
}
|
|
@@ -671,16 +630,11 @@
|
|
|
671
630
|
},
|
|
672
631
|
"/1/compositions/{compositionID}/rules/{objectID}": {
|
|
673
632
|
"get": {
|
|
674
|
-
"tags": [
|
|
675
|
-
"Composition Rules"
|
|
676
|
-
],
|
|
633
|
+
"tags": ["Composition Rules"],
|
|
677
634
|
"operationId": "getRule",
|
|
678
|
-
"x-acl": [
|
|
679
|
-
"editSettings",
|
|
680
|
-
"settings"
|
|
681
|
-
],
|
|
635
|
+
"x-acl": ["editSettings", "settings"],
|
|
682
636
|
"summary": "Retrieve a rule",
|
|
683
|
-
"description": "Retrieves a rule by its ID.\nTo find the object ID of
|
|
637
|
+
"description": "Retrieves a rule by its ID.\n\nTo find the object ID of a rule, use the [`search` operation](https://www.algolia.com/doc/rest-api/composition/search-composition-rules).\n",
|
|
684
638
|
"parameters": [
|
|
685
639
|
{
|
|
686
640
|
"$ref": "#/components/parameters/compositionID"
|
|
@@ -715,15 +669,11 @@
|
|
|
715
669
|
}
|
|
716
670
|
},
|
|
717
671
|
"put": {
|
|
718
|
-
"tags": [
|
|
719
|
-
"Composition Rules"
|
|
720
|
-
],
|
|
672
|
+
"tags": ["Composition Rules"],
|
|
721
673
|
"operationId": "putCompositionRule",
|
|
722
|
-
"x-acl": [
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
"summary": "Upsert a composition rule",
|
|
726
|
-
"description": "Upsert a Composition Rule for the specified composition ID.\n",
|
|
674
|
+
"x-acl": ["editSettings"],
|
|
675
|
+
"summary": "Add or update a composition rule",
|
|
676
|
+
"description": "If a composition rule with the provided ID already exists,\nit's replaced. Otherwise, a new one is added.\n",
|
|
727
677
|
"parameters": [
|
|
728
678
|
{
|
|
729
679
|
"$ref": "#/components/parameters/compositionID"
|
|
@@ -756,9 +706,7 @@
|
|
|
756
706
|
"$ref": "#/components/schemas/taskID"
|
|
757
707
|
}
|
|
758
708
|
},
|
|
759
|
-
"required": [
|
|
760
|
-
"taskID"
|
|
761
|
-
]
|
|
709
|
+
"required": ["taskID"]
|
|
762
710
|
}
|
|
763
711
|
}
|
|
764
712
|
}
|
|
@@ -781,13 +729,9 @@
|
|
|
781
729
|
}
|
|
782
730
|
},
|
|
783
731
|
"delete": {
|
|
784
|
-
"tags": [
|
|
785
|
-
"Composition Rules"
|
|
786
|
-
],
|
|
732
|
+
"tags": ["Composition Rules"],
|
|
787
733
|
"operationId": "deleteCompositionRule",
|
|
788
|
-
"x-acl": [
|
|
789
|
-
"editSettings"
|
|
790
|
-
],
|
|
734
|
+
"x-acl": ["editSettings"],
|
|
791
735
|
"summary": "Delete a Composition Rule",
|
|
792
736
|
"description": "Delete a Composition Rule from the specified Composition ID.\n",
|
|
793
737
|
"parameters": [
|
|
@@ -812,9 +756,7 @@
|
|
|
812
756
|
"$ref": "#/components/schemas/taskID"
|
|
813
757
|
}
|
|
814
758
|
},
|
|
815
|
-
"required": [
|
|
816
|
-
"taskID"
|
|
817
|
-
]
|
|
759
|
+
"required": ["taskID"]
|
|
818
760
|
}
|
|
819
761
|
}
|
|
820
762
|
}
|
|
@@ -836,13 +778,9 @@
|
|
|
836
778
|
},
|
|
837
779
|
"/1/compositions/{compositionID}/rules/batch": {
|
|
838
780
|
"post": {
|
|
839
|
-
"tags": [
|
|
840
|
-
"Composition Rules"
|
|
841
|
-
],
|
|
781
|
+
"tags": ["Composition Rules"],
|
|
842
782
|
"operationId": "saveRules",
|
|
843
|
-
"x-acl": [
|
|
844
|
-
"editSettings"
|
|
845
|
-
],
|
|
783
|
+
"x-acl": ["editSettings"],
|
|
846
784
|
"summary": "Create or update or delete composition rules",
|
|
847
785
|
"description": "Create or update or delete multiple composition rules.\n",
|
|
848
786
|
"x-codegen-request-body-name": "rules",
|
|
@@ -875,10 +813,7 @@
|
|
|
875
813
|
"$ref": "#/components/schemas/rulesBatchCompositionAction"
|
|
876
814
|
}
|
|
877
815
|
},
|
|
878
|
-
"required": [
|
|
879
|
-
"action",
|
|
880
|
-
"body"
|
|
881
|
-
]
|
|
816
|
+
"required": ["action", "body"]
|
|
882
817
|
}
|
|
883
818
|
}
|
|
884
819
|
}
|
|
@@ -900,9 +835,7 @@
|
|
|
900
835
|
"$ref": "#/components/schemas/taskID"
|
|
901
836
|
}
|
|
902
837
|
},
|
|
903
|
-
"required": [
|
|
904
|
-
"taskID"
|
|
905
|
-
]
|
|
838
|
+
"required": ["taskID"]
|
|
906
839
|
}
|
|
907
840
|
}
|
|
908
841
|
}
|
|
@@ -924,13 +857,9 @@
|
|
|
924
857
|
},
|
|
925
858
|
"/1/compositions/{compositionID}/rules/search": {
|
|
926
859
|
"post": {
|
|
927
|
-
"tags": [
|
|
928
|
-
"Composition Rules"
|
|
929
|
-
],
|
|
860
|
+
"tags": ["Composition Rules"],
|
|
930
861
|
"operationId": "searchCompositionRules",
|
|
931
|
-
"x-acl": [
|
|
932
|
-
"settings"
|
|
933
|
-
],
|
|
862
|
+
"x-acl": ["settings"],
|
|
934
863
|
"summary": "Search for composition rules",
|
|
935
864
|
"description": "Searches for composition rules in your index.",
|
|
936
865
|
"parameters": [
|
|
@@ -990,12 +919,7 @@
|
|
|
990
919
|
"title": "searchCompositionRulesResponse",
|
|
991
920
|
"type": "object",
|
|
992
921
|
"additionalProperties": false,
|
|
993
|
-
"required": [
|
|
994
|
-
"hits",
|
|
995
|
-
"nbHits",
|
|
996
|
-
"page",
|
|
997
|
-
"nbPages"
|
|
998
|
-
],
|
|
922
|
+
"required": ["hits", "nbHits", "page", "nbPages"],
|
|
999
923
|
"properties": {
|
|
1000
924
|
"hits": {
|
|
1001
925
|
"type": "array",
|
|
@@ -1038,17 +962,9 @@
|
|
|
1038
962
|
},
|
|
1039
963
|
"/1/compositions/{compositionID}/task/{taskID}": {
|
|
1040
964
|
"get": {
|
|
1041
|
-
"tags": [
|
|
1042
|
-
"Advanced"
|
|
1043
|
-
],
|
|
965
|
+
"tags": ["Advanced"],
|
|
1044
966
|
"operationId": "getTask",
|
|
1045
|
-
"x-acl": [
|
|
1046
|
-
"editSettings",
|
|
1047
|
-
"settings",
|
|
1048
|
-
"addObject",
|
|
1049
|
-
"deleteObject",
|
|
1050
|
-
"deleteIndex"
|
|
1051
|
-
],
|
|
967
|
+
"x-acl": ["editSettings", "settings", "addObject", "deleteObject", "deleteIndex"],
|
|
1052
968
|
"description": "Checks the status of a given task.\n",
|
|
1053
969
|
"summary": "Check task status",
|
|
1054
970
|
"parameters": [
|
|
@@ -1097,9 +1013,7 @@
|
|
|
1097
1013
|
"get": {
|
|
1098
1014
|
"x-helper": true,
|
|
1099
1015
|
"x-asynchronous-helper": false,
|
|
1100
|
-
"tags": [
|
|
1101
|
-
"Api Key"
|
|
1102
|
-
],
|
|
1016
|
+
"tags": ["Api Key"],
|
|
1103
1017
|
"operationId": "setClientApiKey",
|
|
1104
1018
|
"summary": "Switch the API key used to authenticate requests",
|
|
1105
1019
|
"description": "Switch the API key used to authenticate requests.\n",
|
|
@@ -1124,9 +1038,7 @@
|
|
|
1124
1038
|
"/waitForCompositionTask": {
|
|
1125
1039
|
"get": {
|
|
1126
1040
|
"x-helper": true,
|
|
1127
|
-
"tags": [
|
|
1128
|
-
"Records"
|
|
1129
|
-
],
|
|
1041
|
+
"tags": ["Records"],
|
|
1130
1042
|
"operationId": "waitForCompositionTask",
|
|
1131
1043
|
"summary": "Wait for operation to complete",
|
|
1132
1044
|
"description": "Wait for a task to complete to ensure synchronized composition updates.\n\nAll Algolia write operations are asynchronous. When you make a request for a write operation, for example, to upsert or delete a composition, Algolia creates a task on a queue and returns a taskID. The task itself runs separately, depending on the server load.\n",
|
|
@@ -1273,53 +1185,37 @@
|
|
|
1273
1185
|
"type": "string",
|
|
1274
1186
|
"description": "Search query.",
|
|
1275
1187
|
"default": "",
|
|
1276
|
-
"x-categories": [
|
|
1277
|
-
"Search"
|
|
1278
|
-
]
|
|
1188
|
+
"x-categories": ["Search"]
|
|
1279
1189
|
},
|
|
1280
1190
|
"filters": {
|
|
1281
1191
|
"type": "string",
|
|
1282
|
-
"description": "Filter expression to only include items that match the filter criteria in the response.\n\nYou can use these filter expressions:\n\n- **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`.\n- **Ranges.** `<facet>:<lower> TO <upper>` where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive).\n- **Facet filters.** `<facet>:<value>` where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value.\n- **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive).\n- **Boolean filters.** `<facet>: true | false`.\n\nYou can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions:\n\n- You can only combine filters of the same type with `OR`.\n **Not supported:** `facet:value OR num > 3`.\n- You can't use `NOT` with combinations of filters.\n **Not supported:** `NOT(facet:value OR facet:value)`\n- You can't combine conjunctions (`AND`) with `OR`.\n **Not supported:** `facet:value OR (facet:value AND facet:value)`\n\nUse quotes around your filters, if the facet attribute name or facet value has spaces, keywords (`OR`, `AND`, `NOT`), or quotes.\nIf a facet attribute is an array, the filter matches if it matches at least one element of the array.\n\nFor more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering
|
|
1192
|
+
"description": "Filter expression to only include items that match the filter criteria in the response.\n\nYou can use these filter expressions:\n\n- **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`.\n- **Ranges.** `<facet>:<lower> TO <upper>` where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive).\n- **Facet filters.** `<facet>:<value>` where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value.\n- **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive).\n- **Boolean filters.** `<facet>: true | false`.\n\nYou can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions:\n\n- You can only combine filters of the same type with `OR`.\n **Not supported:** `facet:value OR num > 3`.\n- You can't use `NOT` with combinations of filters.\n **Not supported:** `NOT(facet:value OR facet:value)`\n- You can't combine conjunctions (`AND`) with `OR`.\n **Not supported:** `facet:value OR (facet:value AND facet:value)`\n\nUse quotes around your filters, if the facet attribute name or facet value has spaces, keywords (`OR`, `AND`, `NOT`), or quotes.\nIf a facet attribute is an array, the filter matches if it matches at least one element of the array.\n\nFor more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering).\n",
|
|
1283
1193
|
"example": "(category:Book OR category:Ebook) AND _tags:published",
|
|
1284
|
-
"x-categories": [
|
|
1285
|
-
"Filtering"
|
|
1286
|
-
]
|
|
1194
|
+
"x-categories": ["Filtering"]
|
|
1287
1195
|
},
|
|
1288
1196
|
"page": {
|
|
1289
1197
|
"type": "integer",
|
|
1290
1198
|
"description": "Page of search results to retrieve.",
|
|
1291
1199
|
"default": 0,
|
|
1292
1200
|
"minimum": 0,
|
|
1293
|
-
"x-categories": [
|
|
1294
|
-
"Pagination"
|
|
1295
|
-
]
|
|
1201
|
+
"x-categories": ["Pagination"]
|
|
1296
1202
|
},
|
|
1297
1203
|
"getRankingInfo": {
|
|
1298
1204
|
"type": "boolean",
|
|
1299
1205
|
"description": "Whether the run response should include detailed ranking information.",
|
|
1300
1206
|
"default": false,
|
|
1301
|
-
"x-categories": [
|
|
1302
|
-
"Advanced"
|
|
1303
|
-
]
|
|
1207
|
+
"x-categories": ["Advanced"]
|
|
1304
1208
|
},
|
|
1305
1209
|
"relevancyStrictness": {
|
|
1306
1210
|
"type": "integer",
|
|
1307
1211
|
"example": 90,
|
|
1308
1212
|
"description": "Relevancy threshold below which less relevant results aren't included in the results\nYou can only set `relevancyStrictness` on [virtual replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/replicas/#what-are-virtual-replicas).\nUse this setting to strike a balance between the relevance and number of returned results.\n",
|
|
1309
1213
|
"default": 100,
|
|
1310
|
-
"x-categories": [
|
|
1311
|
-
"Ranking"
|
|
1312
|
-
]
|
|
1214
|
+
"x-categories": ["Ranking"]
|
|
1313
1215
|
},
|
|
1314
1216
|
"facetFilters": {
|
|
1315
1217
|
"description": "Filter the search by facet values, so that only records with the same facet values are retrieved.\n\n**Prefer using the `filters` parameter, which supports all filter types and combinations with boolean operators.**\n\n- `[filter1, filter2]` is interpreted as `filter1 AND filter2`.\n- `[[filter1, filter2], filter3]` is interpreted as `filter1 OR filter2 AND filter3`.\n- `facet:-value` is interpreted as `NOT facet:value`.\n\nWhile it's best to avoid attributes that start with a `-`, you can still filter them by escaping with a backslash:\n`facet:\\-value`.\n",
|
|
1316
|
-
"example": [
|
|
1317
|
-
[
|
|
1318
|
-
"category:Book",
|
|
1319
|
-
"category:-Movie"
|
|
1320
|
-
],
|
|
1321
|
-
"author:John Doe"
|
|
1322
|
-
],
|
|
1218
|
+
"example": [["category:Book", "category:-Movie"], "author:John Doe"],
|
|
1323
1219
|
"oneOf": [
|
|
1324
1220
|
{
|
|
1325
1221
|
"type": "array",
|
|
@@ -1331,16 +1227,11 @@
|
|
|
1331
1227
|
"type": "string"
|
|
1332
1228
|
}
|
|
1333
1229
|
],
|
|
1334
|
-
"x-categories": [
|
|
1335
|
-
"Filtering"
|
|
1336
|
-
]
|
|
1230
|
+
"x-categories": ["Filtering"]
|
|
1337
1231
|
},
|
|
1338
1232
|
"optionalFilters": {
|
|
1339
|
-
"description": "Filters to promote or demote records in the search results.\n\nOptional filters work like facet filters, but they don't exclude records from the search results.\nRecords that match the optional filter rank before records that don't match.\nIf you're using a negative filter `facet:-value`, matching records rank after records that don't match.\n\n- Optional filters don't work on virtual replicas.\n- Optional filters are applied _after_ sort-by attributes.\n- Optional filters are applied _before_ custom ranking attributes (in the default [ranking](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria
|
|
1340
|
-
"example": [
|
|
1341
|
-
"category:Book",
|
|
1342
|
-
"author:John Doe"
|
|
1343
|
-
],
|
|
1233
|
+
"description": "Filters to promote or demote records in the search results.\n\nOptional filters work like facet filters, but they don't exclude records from the search results.\nRecords that match the optional filter rank before records that don't match.\nIf you're using a negative filter `facet:-value`, matching records rank after records that don't match.\n\n- Optional filters don't work on virtual replicas.\n- Optional filters are applied _after_ sort-by attributes.\n- Optional filters are applied _before_ custom ranking attributes (in the default [ranking](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria)).\n- Optional filters don't work with numeric attributes.\n",
|
|
1234
|
+
"example": ["category:Book", "author:John Doe"],
|
|
1344
1235
|
"oneOf": [
|
|
1345
1236
|
{
|
|
1346
1237
|
"type": "array",
|
|
@@ -1352,19 +1243,11 @@
|
|
|
1352
1243
|
"type": "string"
|
|
1353
1244
|
}
|
|
1354
1245
|
],
|
|
1355
|
-
"x-categories": [
|
|
1356
|
-
"Filtering"
|
|
1357
|
-
]
|
|
1246
|
+
"x-categories": ["Filtering"]
|
|
1358
1247
|
},
|
|
1359
1248
|
"numericFilters": {
|
|
1360
1249
|
"description": "Filter by numeric facets.\n\n**Prefer using the `filters` parameter, which supports all filter types and combinations with boolean operators.**\n\nYou can use numeric comparison operators: `<`, `<=`, `=`, `!=`, `>`, `>=`.\nComparisons are precise up to 3 decimals.\nYou can also provide ranges: `facet:<lower> TO <upper>`. The range includes the lower and upper boundaries.\nThe same combination rules apply as for `facetFilters`.\n",
|
|
1361
|
-
"example": [
|
|
1362
|
-
[
|
|
1363
|
-
"inStock = 1",
|
|
1364
|
-
"deliveryDate < 1441755506"
|
|
1365
|
-
],
|
|
1366
|
-
"price < 1000"
|
|
1367
|
-
],
|
|
1250
|
+
"example": [["inStock = 1", "deliveryDate < 1441755506"], "price < 1000"],
|
|
1368
1251
|
"oneOf": [
|
|
1369
1252
|
{
|
|
1370
1253
|
"type": "array",
|
|
@@ -1376,9 +1259,7 @@
|
|
|
1376
1259
|
"type": "string"
|
|
1377
1260
|
}
|
|
1378
1261
|
],
|
|
1379
|
-
"x-categories": [
|
|
1380
|
-
"Filtering"
|
|
1381
|
-
]
|
|
1262
|
+
"x-categories": ["Filtering"]
|
|
1382
1263
|
},
|
|
1383
1264
|
"hitsPerPage": {
|
|
1384
1265
|
"type": "integer",
|
|
@@ -1386,34 +1267,26 @@
|
|
|
1386
1267
|
"default": 20,
|
|
1387
1268
|
"minimum": 1,
|
|
1388
1269
|
"maximum": 1000,
|
|
1389
|
-
"x-categories": [
|
|
1390
|
-
"Pagination"
|
|
1391
|
-
]
|
|
1270
|
+
"x-categories": ["Pagination"]
|
|
1392
1271
|
},
|
|
1393
1272
|
"aroundLatLng": {
|
|
1394
1273
|
"type": "string",
|
|
1395
1274
|
"description": "Coordinates for the center of a circle, expressed as a comma-separated string of latitude and longitude.\n\nOnly records included within a circle around this central location are included in the results.\nThe radius of the circle is determined by the `aroundRadius` and `minimumAroundRadius` settings.\nThis parameter is ignored if you also specify `insidePolygon` or `insideBoundingBox`.\n",
|
|
1396
1275
|
"example": "40.71,-74.01",
|
|
1397
1276
|
"default": "",
|
|
1398
|
-
"x-categories": [
|
|
1399
|
-
"Geo-Search"
|
|
1400
|
-
]
|
|
1277
|
+
"x-categories": ["Geo-Search"]
|
|
1401
1278
|
},
|
|
1402
1279
|
"aroundLatLngViaIP": {
|
|
1403
1280
|
"type": "boolean",
|
|
1404
1281
|
"description": "Whether to obtain the coordinates from the request's IP address.",
|
|
1405
1282
|
"default": false,
|
|
1406
|
-
"x-categories": [
|
|
1407
|
-
"Geo-Search"
|
|
1408
|
-
]
|
|
1283
|
+
"x-categories": ["Geo-Search"]
|
|
1409
1284
|
},
|
|
1410
1285
|
"aroundRadiusAll": {
|
|
1411
1286
|
"title": "all",
|
|
1412
1287
|
"type": "string",
|
|
1413
1288
|
"description": "Return all records with a valid `_geoloc` attribute. Don't filter by distance.",
|
|
1414
|
-
"enum": [
|
|
1415
|
-
"all"
|
|
1416
|
-
]
|
|
1289
|
+
"enum": ["all"]
|
|
1417
1290
|
},
|
|
1418
1291
|
"aroundRadius": {
|
|
1419
1292
|
"description": "Maximum radius for a search around a central location.\n\nThis parameter works in combination with the `aroundLatLng` and `aroundLatLngViaIP` parameters.\nBy default, the search radius is determined automatically from the density of hits around the central location.\nThe search radius is small if there are many hits close to the central coordinates.\n",
|
|
@@ -1427,9 +1300,7 @@
|
|
|
1427
1300
|
"$ref": "#/components/schemas/aroundRadiusAll"
|
|
1428
1301
|
}
|
|
1429
1302
|
],
|
|
1430
|
-
"x-categories": [
|
|
1431
|
-
"Geo-Search"
|
|
1432
|
-
]
|
|
1303
|
+
"x-categories": ["Geo-Search"]
|
|
1433
1304
|
},
|
|
1434
1305
|
"aroundPrecisionFromValue": {
|
|
1435
1306
|
"title": "range objects",
|
|
@@ -1463,17 +1334,13 @@
|
|
|
1463
1334
|
"$ref": "#/components/schemas/aroundPrecisionFromValue"
|
|
1464
1335
|
}
|
|
1465
1336
|
],
|
|
1466
|
-
"x-categories": [
|
|
1467
|
-
"Geo-Search"
|
|
1468
|
-
]
|
|
1337
|
+
"x-categories": ["Geo-Search"]
|
|
1469
1338
|
},
|
|
1470
1339
|
"minimumAroundRadius": {
|
|
1471
1340
|
"type": "integer",
|
|
1472
1341
|
"description": "Minimum radius (in meters) for a search around a location when `aroundRadius` isn't set.",
|
|
1473
1342
|
"minimum": 1,
|
|
1474
|
-
"x-categories": [
|
|
1475
|
-
"Geo-Search"
|
|
1476
|
-
]
|
|
1343
|
+
"x-categories": ["Geo-Search"]
|
|
1477
1344
|
},
|
|
1478
1345
|
"insideBoundingBoxArray": {
|
|
1479
1346
|
"type": "array",
|
|
@@ -1488,22 +1355,10 @@
|
|
|
1488
1355
|
},
|
|
1489
1356
|
"description": "Coordinates for a rectangular area in which to search.\n\nEach bounding box is defined by the two opposite points of its diagonal, and expressed as latitude and longitude pair:\n`[p1 lat, p1 long, p2 lat, p2 long]`.\nProvide multiple bounding boxes as nested arrays.\nFor more information, see [rectangular area](https://www.algolia.com/doc/guides/managing-results/refine-results/geolocation/#filtering-inside-rectangular-or-polygonal-areas).\n",
|
|
1490
1357
|
"example": [
|
|
1491
|
-
[
|
|
1492
|
-
|
|
1493
|
-
4.9665,
|
|
1494
|
-
47.3424,
|
|
1495
|
-
5.0201
|
|
1496
|
-
],
|
|
1497
|
-
[
|
|
1498
|
-
40.9234,
|
|
1499
|
-
2.1185,
|
|
1500
|
-
38.643,
|
|
1501
|
-
1.9916
|
|
1502
|
-
]
|
|
1358
|
+
[47.3165, 4.9665, 47.3424, 5.0201],
|
|
1359
|
+
[40.9234, 2.1185, 38.643, 1.9916]
|
|
1503
1360
|
],
|
|
1504
|
-
"x-categories": [
|
|
1505
|
-
"Geo-Search"
|
|
1506
|
-
]
|
|
1361
|
+
"x-categories": ["Geo-Search"]
|
|
1507
1362
|
},
|
|
1508
1363
|
"insideBoundingBox": {
|
|
1509
1364
|
"oneOf": [
|
|
@@ -1531,26 +1386,10 @@
|
|
|
1531
1386
|
},
|
|
1532
1387
|
"description": "Coordinates of a polygon in which to search.\n\nPolygons are defined by 3 to 10,000 points. Each point is represented by its latitude and longitude.\nProvide multiple polygons as nested arrays.\nFor more information, see [filtering inside polygons](https://www.algolia.com/doc/guides/managing-results/refine-results/geolocation/#filtering-inside-rectangular-or-polygonal-areas).\nThis parameter is ignored if you also specify `insideBoundingBox`.\n",
|
|
1533
1388
|
"example": [
|
|
1534
|
-
[
|
|
1535
|
-
|
|
1536
|
-
4.9665,
|
|
1537
|
-
47.3424,
|
|
1538
|
-
5.0201,
|
|
1539
|
-
47.32,
|
|
1540
|
-
4.9
|
|
1541
|
-
],
|
|
1542
|
-
[
|
|
1543
|
-
40.9234,
|
|
1544
|
-
2.1185,
|
|
1545
|
-
38.643,
|
|
1546
|
-
1.9916,
|
|
1547
|
-
39.2587,
|
|
1548
|
-
2.0104
|
|
1549
|
-
]
|
|
1389
|
+
[47.3165, 4.9665, 47.3424, 5.0201, 47.32, 4.9],
|
|
1390
|
+
[40.9234, 2.1185, 38.643, 1.9916, 39.2587, 2.0104]
|
|
1550
1391
|
],
|
|
1551
|
-
"x-categories": [
|
|
1552
|
-
"Geo-Search"
|
|
1553
|
-
]
|
|
1392
|
+
"x-categories": ["Geo-Search"]
|
|
1554
1393
|
},
|
|
1555
1394
|
"supportedLanguage": {
|
|
1556
1395
|
"type": "string",
|
|
@@ -1631,14 +1470,10 @@
|
|
|
1631
1470
|
"items": {
|
|
1632
1471
|
"$ref": "#/components/schemas/supportedLanguage"
|
|
1633
1472
|
},
|
|
1634
|
-
"example": [
|
|
1635
|
-
|
|
1636
|
-
],
|
|
1637
|
-
"description": "Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries \nThis setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings.\nThis setting also sets a dictionary for word detection in the logogram-based [CJK](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization/#normalization-for-logogram-based-languages-cjk) languages.\nTo support this, you must place the CJK language **first** \n**You should always specify a query language.**\nIf you don't specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/),\nor the languages you specified with the `ignorePlurals` or `removeStopWords` parameters.\nThis can lead to unexpected search results.\nFor more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations/).\n",
|
|
1473
|
+
"example": ["es"],
|
|
1474
|
+
"description": "Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries \nThis setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings.\nThis setting also sets a dictionary for word detection in the logogram-based [CJK](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization/#normalization-for-logogram-based-languages-cjk) languages.\nTo support this, you must place the CJK language **first** \n**You should always specify a query language.**\nIf you don't specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages),\nor the languages you specified with the `ignorePlurals` or `removeStopWords` parameters.\nThis can lead to unexpected search results.\nFor more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations).\n",
|
|
1638
1475
|
"default": [],
|
|
1639
|
-
"x-categories": [
|
|
1640
|
-
"Languages"
|
|
1641
|
-
]
|
|
1476
|
+
"x-categories": ["Languages"]
|
|
1642
1477
|
},
|
|
1643
1478
|
"naturalLanguages": {
|
|
1644
1479
|
"type": "array",
|
|
@@ -1647,17 +1482,13 @@
|
|
|
1647
1482
|
},
|
|
1648
1483
|
"description": "ISO language codes that adjust settings that are useful for processing natural language queries (as opposed to keyword searches)\n- Sets `removeStopWords` and `ignorePlurals` to the list of provided languages.\n- Sets `removeWordsIfNoResults` to `allOptional`.\n- Adds a `natural_language` attribute to `ruleContexts` and `analyticsTags`.\n",
|
|
1649
1484
|
"default": [],
|
|
1650
|
-
"x-categories": [
|
|
1651
|
-
"Languages"
|
|
1652
|
-
]
|
|
1485
|
+
"x-categories": ["Languages"]
|
|
1653
1486
|
},
|
|
1654
1487
|
"enableRules": {
|
|
1655
1488
|
"type": "boolean",
|
|
1656
1489
|
"description": "Whether to enable composition rules.",
|
|
1657
1490
|
"default": true,
|
|
1658
|
-
"x-categories": [
|
|
1659
|
-
"Composition Rules"
|
|
1660
|
-
]
|
|
1491
|
+
"x-categories": ["Composition Rules"]
|
|
1661
1492
|
},
|
|
1662
1493
|
"ruleContexts": {
|
|
1663
1494
|
"type": "array",
|
|
@@ -1666,60 +1497,46 @@
|
|
|
1666
1497
|
},
|
|
1667
1498
|
"description": "Assigns a rule context to the run query\n[Rule contexts](https://www.algolia.com/doc/guides/managing-results/rules/rules-overview/how-to/customize-search-results-by-platform/#whats-a-context) are strings that you can use to trigger matching rules.\n",
|
|
1668
1499
|
"default": [],
|
|
1669
|
-
"example": [
|
|
1670
|
-
|
|
1671
|
-
],
|
|
1672
|
-
"x-categories": [
|
|
1673
|
-
"Composition Rules"
|
|
1674
|
-
]
|
|
1500
|
+
"example": ["mobile"],
|
|
1501
|
+
"x-categories": ["Composition Rules"]
|
|
1675
1502
|
},
|
|
1676
1503
|
"userToken": {
|
|
1677
1504
|
"type": "string",
|
|
1678
|
-
"description": "Unique pseudonymous or anonymous user identifier.\n\nThis helps with analytics and click and conversion events.\nFor more information, see [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken
|
|
1505
|
+
"description": "Unique pseudonymous or anonymous user identifier.\n\nThis helps with analytics and click and conversion events.\nFor more information, see [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).\n",
|
|
1679
1506
|
"example": "test-user-123",
|
|
1680
|
-
"x-categories": [
|
|
1681
|
-
"Personalization"
|
|
1682
|
-
]
|
|
1507
|
+
"x-categories": ["Personalization"]
|
|
1683
1508
|
},
|
|
1684
1509
|
"clickAnalytics": {
|
|
1685
1510
|
"type": "boolean",
|
|
1686
|
-
"description": "Whether to include a `queryID` attribute in the response\nThe query ID is a unique identifier for a search query and is required for tracking [click and conversion events](https://www.algolia.com/guides/sending-events/getting-started
|
|
1511
|
+
"description": "Whether to include a `queryID` attribute in the response\nThe query ID is a unique identifier for a search query and is required for tracking [click and conversion events](https://www.algolia.com/guides/sending-events/getting-started).\n",
|
|
1687
1512
|
"default": false,
|
|
1688
|
-
"x-categories": [
|
|
1689
|
-
"Analytics"
|
|
1690
|
-
]
|
|
1513
|
+
"x-categories": ["Analytics"]
|
|
1691
1514
|
},
|
|
1692
1515
|
"analytics": {
|
|
1693
1516
|
"type": "boolean",
|
|
1694
1517
|
"description": "Whether this search will be included in Analytics.",
|
|
1695
1518
|
"default": true,
|
|
1696
|
-
"x-categories": [
|
|
1697
|
-
"Analytics"
|
|
1698
|
-
]
|
|
1519
|
+
"x-categories": ["Analytics"]
|
|
1699
1520
|
},
|
|
1700
1521
|
"analyticsTags": {
|
|
1701
1522
|
"type": "array",
|
|
1702
1523
|
"items": {
|
|
1703
1524
|
"type": "string"
|
|
1704
1525
|
},
|
|
1705
|
-
"description": "Tags to apply to the query for [segmenting analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments
|
|
1526
|
+
"description": "Tags to apply to the query for [segmenting analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments).",
|
|
1706
1527
|
"default": []
|
|
1707
1528
|
},
|
|
1708
1529
|
"enableABTest": {
|
|
1709
1530
|
"type": "boolean",
|
|
1710
1531
|
"description": "Whether to enable index level A/B testing for this run request.\nIf the composition mixes multiple indices, the A/B test is ignored.\n",
|
|
1711
1532
|
"default": true,
|
|
1712
|
-
"x-categories": [
|
|
1713
|
-
"Advanced"
|
|
1714
|
-
]
|
|
1533
|
+
"x-categories": ["Advanced"]
|
|
1715
1534
|
},
|
|
1716
1535
|
"enableReRanking": {
|
|
1717
1536
|
"type": "boolean",
|
|
1718
|
-
"description": "Whether this search will use [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking
|
|
1537
|
+
"description": "Whether this search will use [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking)\nThis setting only has an effect if you activated Dynamic Re-Ranking for this index in the Algolia dashboard.\n",
|
|
1719
1538
|
"default": true,
|
|
1720
|
-
"x-categories": [
|
|
1721
|
-
"Filtering"
|
|
1722
|
-
]
|
|
1539
|
+
"x-categories": ["Filtering"]
|
|
1723
1540
|
},
|
|
1724
1541
|
"externalInjectedItem": {
|
|
1725
1542
|
"type": "object",
|
|
@@ -1744,9 +1561,7 @@
|
|
|
1744
1561
|
}
|
|
1745
1562
|
}
|
|
1746
1563
|
},
|
|
1747
|
-
"required": [
|
|
1748
|
-
"objectID"
|
|
1749
|
-
],
|
|
1564
|
+
"required": ["objectID"],
|
|
1750
1565
|
"example": {
|
|
1751
1566
|
"objectID": "my-object-1",
|
|
1752
1567
|
"metadata": {
|
|
@@ -1756,9 +1571,7 @@
|
|
|
1756
1571
|
}
|
|
1757
1572
|
}
|
|
1758
1573
|
},
|
|
1759
|
-
"required": [
|
|
1760
|
-
"items"
|
|
1761
|
-
]
|
|
1574
|
+
"required": ["items"]
|
|
1762
1575
|
},
|
|
1763
1576
|
"injectedItems": {
|
|
1764
1577
|
"type": "object",
|
|
@@ -1767,9 +1580,7 @@
|
|
|
1767
1580
|
},
|
|
1768
1581
|
"description": "A list of extenrally injected objectID groups into from an external source.\n",
|
|
1769
1582
|
"default": {},
|
|
1770
|
-
"x-categories": [
|
|
1771
|
-
"Retail Media Network"
|
|
1772
|
-
]
|
|
1583
|
+
"x-categories": ["Retail Media Network"]
|
|
1773
1584
|
},
|
|
1774
1585
|
"params": {
|
|
1775
1586
|
"title": "Run composition parameters as object",
|
|
@@ -1881,15 +1692,11 @@
|
|
|
1881
1692
|
"$ref": "#/components/schemas/objectID"
|
|
1882
1693
|
}
|
|
1883
1694
|
},
|
|
1884
|
-
"required": [
|
|
1885
|
-
"objectID"
|
|
1886
|
-
]
|
|
1695
|
+
"required": ["objectID"]
|
|
1887
1696
|
}
|
|
1888
1697
|
}
|
|
1889
1698
|
},
|
|
1890
|
-
"required": [
|
|
1891
|
-
"objectID"
|
|
1892
|
-
]
|
|
1699
|
+
"required": ["objectID"]
|
|
1893
1700
|
},
|
|
1894
1701
|
"compositionsSearchResponse": {
|
|
1895
1702
|
"type": "object",
|
|
@@ -1902,16 +1709,12 @@
|
|
|
1902
1709
|
}
|
|
1903
1710
|
}
|
|
1904
1711
|
},
|
|
1905
|
-
"required": [
|
|
1906
|
-
"run"
|
|
1907
|
-
]
|
|
1712
|
+
"required": ["run"]
|
|
1908
1713
|
},
|
|
1909
1714
|
"compositionBaseSearchResponse": {
|
|
1910
1715
|
"type": "object",
|
|
1911
1716
|
"additionalProperties": true,
|
|
1912
|
-
"required": [
|
|
1913
|
-
"processingTimeMS"
|
|
1914
|
-
],
|
|
1717
|
+
"required": ["processingTimeMS"],
|
|
1915
1718
|
"properties": {
|
|
1916
1719
|
"compositions": {
|
|
1917
1720
|
"$ref": "#/components/schemas/compositionsSearchResponse"
|
|
@@ -1946,9 +1749,7 @@
|
|
|
1946
1749
|
"title": "redirectRuleIndexData",
|
|
1947
1750
|
"type": "object",
|
|
1948
1751
|
"description": "Redirect rule data.",
|
|
1949
|
-
"required": [
|
|
1950
|
-
"ruleObjectID"
|
|
1951
|
-
],
|
|
1752
|
+
"required": ["ruleObjectID"],
|
|
1952
1753
|
"properties": {
|
|
1953
1754
|
"ruleObjectID": {
|
|
1954
1755
|
"type": "string"
|
|
@@ -1956,13 +1757,7 @@
|
|
|
1956
1757
|
}
|
|
1957
1758
|
}
|
|
1958
1759
|
},
|
|
1959
|
-
"required": [
|
|
1960
|
-
"data",
|
|
1961
|
-
"succeed",
|
|
1962
|
-
"reason",
|
|
1963
|
-
"dest",
|
|
1964
|
-
"source"
|
|
1965
|
-
]
|
|
1760
|
+
"required": ["data", "succeed", "reason", "dest", "source"]
|
|
1966
1761
|
},
|
|
1967
1762
|
"order": {
|
|
1968
1763
|
"description": "Explicit order of facets or facet values.\n\nThis setting lets you always show specific facets or facet values at the top of the list.\n",
|
|
@@ -1984,11 +1779,7 @@
|
|
|
1984
1779
|
"sortRemainingBy": {
|
|
1985
1780
|
"description": "Order of facet values that aren't explicitly positioned with the `order` setting.\n\n- `count`.\n Order remaining facet values by decreasing count.\n The count is the number of matching records containing this facet value.\n\n- `alpha`.\n Sort facet values alphabetically.\n\n- `hidden`.\n Don't show facet values that aren't explicitly positioned.\n",
|
|
1986
1781
|
"type": "string",
|
|
1987
|
-
"enum": [
|
|
1988
|
-
"count",
|
|
1989
|
-
"alpha",
|
|
1990
|
-
"hidden"
|
|
1991
|
-
]
|
|
1782
|
+
"enum": ["count", "alpha", "hidden"]
|
|
1992
1783
|
},
|
|
1993
1784
|
"hide": {
|
|
1994
1785
|
"description": "Hide facet values.",
|
|
@@ -2124,9 +1915,7 @@
|
|
|
2124
1915
|
"$ref": "#/components/schemas/widgets"
|
|
2125
1916
|
}
|
|
2126
1917
|
},
|
|
2127
|
-
"x-categories": [
|
|
2128
|
-
"Advanced"
|
|
2129
|
-
]
|
|
1918
|
+
"x-categories": ["Advanced"]
|
|
2130
1919
|
},
|
|
2131
1920
|
"userData": {
|
|
2132
1921
|
"example": {
|
|
@@ -2135,9 +1924,7 @@
|
|
|
2135
1924
|
},
|
|
2136
1925
|
"description": "An object with custom data.\n\nYou can store up to 32kB as custom data.\n",
|
|
2137
1926
|
"default": {},
|
|
2138
|
-
"x-categories": [
|
|
2139
|
-
"Advanced"
|
|
2140
|
-
]
|
|
1927
|
+
"x-categories": ["Advanced"]
|
|
2141
1928
|
},
|
|
2142
1929
|
"baseSearchResponse": {
|
|
2143
1930
|
"type": "object",
|
|
@@ -2304,7 +2091,7 @@
|
|
|
2304
2091
|
"redirect": {
|
|
2305
2092
|
"title": "redirect",
|
|
2306
2093
|
"type": "object",
|
|
2307
|
-
"description": "[Redirect results to a URL](https://www.algolia.com/doc/guides/managing-results/rules/merchandising-and-promoting/how-to/redirects
|
|
2094
|
+
"description": "[Redirect results to a URL](https://www.algolia.com/doc/guides/managing-results/rules/merchandising-and-promoting/how-to/redirects), this this parameter is for internal use only.\n",
|
|
2308
2095
|
"properties": {
|
|
2309
2096
|
"index": {
|
|
2310
2097
|
"type": "array",
|
|
@@ -2332,7 +2119,7 @@
|
|
|
2332
2119
|
},
|
|
2333
2120
|
"queryID": {
|
|
2334
2121
|
"type": "string",
|
|
2335
|
-
"description": "Unique identifier for the query. This is used for [click analytics](https://www.algolia.com/doc/guides/analytics/click-analytics
|
|
2122
|
+
"description": "Unique identifier for the query. This is used for [click analytics](https://www.algolia.com/doc/guides/analytics/click-analytics).",
|
|
2336
2123
|
"example": "a00dbc80a8d13c4565a442e7e2dca80a"
|
|
2337
2124
|
},
|
|
2338
2125
|
"_automaticInsights": {
|
|
@@ -2368,12 +2155,7 @@
|
|
|
2368
2155
|
"$ref": "#/components/schemas/hitsPerPage"
|
|
2369
2156
|
}
|
|
2370
2157
|
},
|
|
2371
|
-
"required": [
|
|
2372
|
-
"page",
|
|
2373
|
-
"nbHits",
|
|
2374
|
-
"nbPages",
|
|
2375
|
-
"hitsPerPage"
|
|
2376
|
-
]
|
|
2158
|
+
"required": ["page", "nbHits", "nbPages", "hitsPerPage"]
|
|
2377
2159
|
},
|
|
2378
2160
|
"highlightedValue": {
|
|
2379
2161
|
"type": "string",
|
|
@@ -2383,11 +2165,7 @@
|
|
|
2383
2165
|
"matchLevel": {
|
|
2384
2166
|
"type": "string",
|
|
2385
2167
|
"description": "Whether the whole query string matches or only a part.",
|
|
2386
|
-
"enum": [
|
|
2387
|
-
"none",
|
|
2388
|
-
"partial",
|
|
2389
|
-
"full"
|
|
2390
|
-
]
|
|
2168
|
+
"enum": ["none", "partial", "full"]
|
|
2391
2169
|
},
|
|
2392
2170
|
"highlightResultOption": {
|
|
2393
2171
|
"title": "highlightResultOption",
|
|
@@ -2404,9 +2182,7 @@
|
|
|
2404
2182
|
"matchedWords": {
|
|
2405
2183
|
"type": "array",
|
|
2406
2184
|
"description": "List of matched words from the search query.",
|
|
2407
|
-
"example": [
|
|
2408
|
-
"action"
|
|
2409
|
-
],
|
|
2185
|
+
"example": ["action"],
|
|
2410
2186
|
"items": {
|
|
2411
2187
|
"type": "string"
|
|
2412
2188
|
}
|
|
@@ -2416,15 +2192,8 @@
|
|
|
2416
2192
|
"description": "Whether the entire attribute value is highlighted."
|
|
2417
2193
|
}
|
|
2418
2194
|
},
|
|
2419
|
-
"required": [
|
|
2420
|
-
|
|
2421
|
-
"matchLevel",
|
|
2422
|
-
"matchedWords"
|
|
2423
|
-
],
|
|
2424
|
-
"x-discriminator-fields": [
|
|
2425
|
-
"matchLevel",
|
|
2426
|
-
"matchedWords"
|
|
2427
|
-
]
|
|
2195
|
+
"required": ["value", "matchLevel", "matchedWords"],
|
|
2196
|
+
"x-discriminator-fields": ["matchLevel", "matchedWords"]
|
|
2428
2197
|
},
|
|
2429
2198
|
"highlightResultMap": {
|
|
2430
2199
|
"title": "highlightResultMap",
|
|
@@ -2470,13 +2239,8 @@
|
|
|
2470
2239
|
"$ref": "#/components/schemas/matchLevel"
|
|
2471
2240
|
}
|
|
2472
2241
|
},
|
|
2473
|
-
"required": [
|
|
2474
|
-
|
|
2475
|
-
"matchLevel"
|
|
2476
|
-
],
|
|
2477
|
-
"x-discriminator-fields": [
|
|
2478
|
-
"matchLevel"
|
|
2479
|
-
]
|
|
2242
|
+
"required": ["value", "matchLevel"],
|
|
2243
|
+
"x-discriminator-fields": ["matchLevel"]
|
|
2480
2244
|
},
|
|
2481
2245
|
"snippetResultMap": {
|
|
2482
2246
|
"title": "snippetResultMap",
|
|
@@ -2609,13 +2373,7 @@
|
|
|
2609
2373
|
"description": "Whether the record is re-ranked."
|
|
2610
2374
|
}
|
|
2611
2375
|
},
|
|
2612
|
-
"required": [
|
|
2613
|
-
"nbTypos",
|
|
2614
|
-
"firstMatchedWord",
|
|
2615
|
-
"geoDistance",
|
|
2616
|
-
"nbExactWords",
|
|
2617
|
-
"userScore"
|
|
2618
|
-
]
|
|
2376
|
+
"required": ["nbTypos", "firstMatchedWord", "geoDistance", "nbExactWords", "userScore"]
|
|
2619
2377
|
},
|
|
2620
2378
|
"compositionRankingInfo": {
|
|
2621
2379
|
"type": "object",
|
|
@@ -2636,10 +2394,7 @@
|
|
|
2636
2394
|
"type": "string"
|
|
2637
2395
|
}
|
|
2638
2396
|
},
|
|
2639
|
-
"required": [
|
|
2640
|
-
"index",
|
|
2641
|
-
"injectedItemKey"
|
|
2642
|
-
]
|
|
2397
|
+
"required": ["index", "injectedItemKey"]
|
|
2643
2398
|
}
|
|
2644
2399
|
}
|
|
2645
2400
|
}
|
|
@@ -2673,9 +2428,7 @@
|
|
|
2673
2428
|
"description": "Search result.\n\nA hit is a record from your index, augmented with special attributes for highlighting, snippeting, and ranking.\n",
|
|
2674
2429
|
"x-is-generic": true,
|
|
2675
2430
|
"additionalProperties": true,
|
|
2676
|
-
"required": [
|
|
2677
|
-
"objectID"
|
|
2678
|
-
],
|
|
2431
|
+
"required": ["objectID"],
|
|
2679
2432
|
"properties": {
|
|
2680
2433
|
"objectID": {
|
|
2681
2434
|
"$ref": "#/components/schemas/objectID"
|
|
@@ -2717,11 +2470,7 @@
|
|
|
2717
2470
|
"example": "query=a&hitsPerPage=20"
|
|
2718
2471
|
}
|
|
2719
2472
|
},
|
|
2720
|
-
"required": [
|
|
2721
|
-
"hits",
|
|
2722
|
-
"query",
|
|
2723
|
-
"params"
|
|
2724
|
-
]
|
|
2473
|
+
"required": ["hits", "query", "params"]
|
|
2725
2474
|
},
|
|
2726
2475
|
"resultsInjectedItemInfoResponse": {
|
|
2727
2476
|
"type": "object",
|
|
@@ -2740,15 +2489,11 @@
|
|
|
2740
2489
|
"$ref": "#/components/schemas/objectID"
|
|
2741
2490
|
}
|
|
2742
2491
|
},
|
|
2743
|
-
"required": [
|
|
2744
|
-
"objectID"
|
|
2745
|
-
]
|
|
2492
|
+
"required": ["objectID"]
|
|
2746
2493
|
}
|
|
2747
2494
|
}
|
|
2748
2495
|
},
|
|
2749
|
-
"required": [
|
|
2750
|
-
"key"
|
|
2751
|
-
]
|
|
2496
|
+
"required": ["key"]
|
|
2752
2497
|
},
|
|
2753
2498
|
"resultsCompositionsResponse": {
|
|
2754
2499
|
"type": "object",
|
|
@@ -2769,15 +2514,11 @@
|
|
|
2769
2514
|
}
|
|
2770
2515
|
}
|
|
2771
2516
|
},
|
|
2772
|
-
"required": [
|
|
2773
|
-
"injectedItems"
|
|
2774
|
-
]
|
|
2517
|
+
"required": ["injectedItems"]
|
|
2775
2518
|
}
|
|
2776
2519
|
}
|
|
2777
2520
|
},
|
|
2778
|
-
"required": [
|
|
2779
|
-
"compositions"
|
|
2780
|
-
]
|
|
2521
|
+
"required": ["compositions"]
|
|
2781
2522
|
},
|
|
2782
2523
|
"searchResultsItem": {
|
|
2783
2524
|
"allOf": [
|
|
@@ -2807,9 +2548,7 @@
|
|
|
2807
2548
|
}
|
|
2808
2549
|
}
|
|
2809
2550
|
},
|
|
2810
|
-
"required": [
|
|
2811
|
-
"results"
|
|
2812
|
-
]
|
|
2551
|
+
"required": ["results"]
|
|
2813
2552
|
},
|
|
2814
2553
|
"searchResponse": {
|
|
2815
2554
|
"additionalProperties": true,
|
|
@@ -2827,21 +2566,13 @@
|
|
|
2827
2566
|
"description": "Maximum number of facet values to return when [searching for facet values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values).",
|
|
2828
2567
|
"maximum": 100,
|
|
2829
2568
|
"default": 10,
|
|
2830
|
-
"x-categories": [
|
|
2831
|
-
"Advanced"
|
|
2832
|
-
]
|
|
2569
|
+
"x-categories": ["Advanced"]
|
|
2833
2570
|
},
|
|
2834
2571
|
"searchForFacetValuesResults": {
|
|
2835
2572
|
"type": "object",
|
|
2836
2573
|
"additionalProperties": false,
|
|
2837
|
-
"required": [
|
|
2838
|
-
|
|
2839
|
-
"exhaustiveFacetsCount",
|
|
2840
|
-
"indexName"
|
|
2841
|
-
],
|
|
2842
|
-
"x-discriminator-fields": [
|
|
2843
|
-
"facetHits"
|
|
2844
|
-
],
|
|
2574
|
+
"required": ["facetHits", "exhaustiveFacetsCount", "indexName"],
|
|
2575
|
+
"x-discriminator-fields": ["facetHits"],
|
|
2845
2576
|
"properties": {
|
|
2846
2577
|
"indexName": {
|
|
2847
2578
|
"type": "string"
|
|
@@ -2853,11 +2584,7 @@
|
|
|
2853
2584
|
"title": "facetHits",
|
|
2854
2585
|
"type": "object",
|
|
2855
2586
|
"additionalProperties": false,
|
|
2856
|
-
"required": [
|
|
2857
|
-
"value",
|
|
2858
|
-
"highlighted",
|
|
2859
|
-
"count"
|
|
2860
|
-
],
|
|
2587
|
+
"required": ["value", "highlighted", "count"],
|
|
2861
2588
|
"properties": {
|
|
2862
2589
|
"value": {
|
|
2863
2590
|
"description": "Facet value.",
|
|
@@ -2900,19 +2627,12 @@
|
|
|
2900
2627
|
"type": "boolean",
|
|
2901
2628
|
"description": "Whether to support phrase matching and excluding words from search queries\nUse the `advancedSyntaxFeatures` parameter to control which feature is supported.\n",
|
|
2902
2629
|
"default": false,
|
|
2903
|
-
"x-categories": [
|
|
2904
|
-
"Query strategy"
|
|
2905
|
-
]
|
|
2630
|
+
"x-categories": ["Query strategy"]
|
|
2906
2631
|
},
|
|
2907
2632
|
"advancedSyntaxFeatures": {
|
|
2908
2633
|
"type": "string",
|
|
2909
|
-
"enum": [
|
|
2910
|
-
|
|
2911
|
-
"excludeWords"
|
|
2912
|
-
],
|
|
2913
|
-
"x-categories": [
|
|
2914
|
-
"Query strategy"
|
|
2915
|
-
]
|
|
2634
|
+
"enum": ["exactPhrase", "excludeWords"],
|
|
2635
|
+
"x-categories": ["Query strategy"]
|
|
2916
2636
|
},
|
|
2917
2637
|
"IndexSettings_advancedSyntaxFeatures": {
|
|
2918
2638
|
"type": "array",
|
|
@@ -2920,33 +2640,19 @@
|
|
|
2920
2640
|
"$ref": "#/components/schemas/advancedSyntaxFeatures"
|
|
2921
2641
|
},
|
|
2922
2642
|
"description": "Advanced search syntax features you want to support\n- `exactPhrase`.\n Phrases in quotes must match exactly.\n For example, `sparkly blue \"iPhone case\"` only returns records with the exact string \"iPhone case\"\n- `excludeWords`.\n Query words prefixed with a `-` must not occur in a record.\n For example, `search -engine` matches records that contain \"search\" but not \"engine\"\nThis setting only has an effect if `advancedSyntax` is true.\n",
|
|
2923
|
-
"default": [
|
|
2924
|
-
|
|
2925
|
-
"excludeWords"
|
|
2926
|
-
],
|
|
2927
|
-
"x-categories": [
|
|
2928
|
-
"Query strategy"
|
|
2929
|
-
]
|
|
2643
|
+
"default": ["exactPhrase", "excludeWords"],
|
|
2644
|
+
"x-categories": ["Query strategy"]
|
|
2930
2645
|
},
|
|
2931
2646
|
"allowTyposOnNumericTokens": {
|
|
2932
2647
|
"type": "boolean",
|
|
2933
2648
|
"description": "Whether to allow typos on numbers in the search query\nTurn off this setting to reduce the number of irrelevant matches\nwhen searching in large sets of similar numbers.\n",
|
|
2934
2649
|
"default": true,
|
|
2935
|
-
"x-categories": [
|
|
2936
|
-
"Typos"
|
|
2937
|
-
]
|
|
2650
|
+
"x-categories": ["Typos"]
|
|
2938
2651
|
},
|
|
2939
2652
|
"alternativesAsExact": {
|
|
2940
2653
|
"type": "string",
|
|
2941
|
-
"enum": [
|
|
2942
|
-
|
|
2943
|
-
"singleWordSynonym",
|
|
2944
|
-
"multiWordsSynonym",
|
|
2945
|
-
"ignoreConjugations"
|
|
2946
|
-
],
|
|
2947
|
-
"x-categories": [
|
|
2948
|
-
"Query strategy"
|
|
2949
|
-
]
|
|
2654
|
+
"enum": ["ignorePlurals", "singleWordSynonym", "multiWordsSynonym", "ignoreConjugations"],
|
|
2655
|
+
"x-categories": ["Query strategy"]
|
|
2950
2656
|
},
|
|
2951
2657
|
"IndexSettings_alternativesAsExact": {
|
|
2952
2658
|
"type": "array",
|
|
@@ -2954,106 +2660,69 @@
|
|
|
2954
2660
|
"$ref": "#/components/schemas/alternativesAsExact"
|
|
2955
2661
|
},
|
|
2956
2662
|
"description": "Determine which plurals and synonyms should be considered an exact matches\nBy default, Algolia treats singular and plural forms of a word, and single-word synonyms, as [exact](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria/#exact) matches when searching.\nFor example\n- \"swimsuit\" and \"swimsuits\" are treated the same\n- \"swimsuit\" and \"swimwear\" are treated the same (if they are [synonyms](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#regular-synonyms))\n- `ignorePlurals`.\n Plurals and similar declensions added by the `ignorePlurals` setting are considered exact matches\n- `singleWordSynonym`.\n Single-word synonyms, such as \"NY\" = \"NYC\", are considered exact matches\n- `multiWordsSynonym`.\n Multi-word synonyms, such as \"NY\" = \"New York\", are considered exact matches.\n",
|
|
2957
|
-
"default": [
|
|
2958
|
-
|
|
2959
|
-
"singleWordSynonym"
|
|
2960
|
-
],
|
|
2961
|
-
"x-categories": [
|
|
2962
|
-
"Query strategy"
|
|
2963
|
-
]
|
|
2663
|
+
"default": ["ignorePlurals", "singleWordSynonym"],
|
|
2664
|
+
"x-categories": ["Query strategy"]
|
|
2964
2665
|
},
|
|
2965
2666
|
"attributeCriteriaComputedByMinProximity": {
|
|
2966
2667
|
"type": "boolean",
|
|
2967
2668
|
"description": "Whether the best matching attribute should be determined by minimum proximity\nThis setting only affects ranking if the Attribute ranking criterion comes before Proximity in the `ranking` setting.\nIf true, the best matching attribute is selected based on the minimum proximity of multiple matches.\nOtherwise, the best matching attribute is determined by the order in the `searchableAttributes` setting.\n",
|
|
2968
2669
|
"default": false,
|
|
2969
|
-
"x-categories": [
|
|
2970
|
-
"Advanced"
|
|
2971
|
-
]
|
|
2670
|
+
"x-categories": ["Advanced"]
|
|
2972
2671
|
},
|
|
2973
2672
|
"attributesToHighlight": {
|
|
2974
2673
|
"type": "array",
|
|
2975
2674
|
"items": {
|
|
2976
2675
|
"type": "string"
|
|
2977
2676
|
},
|
|
2978
|
-
"example": [
|
|
2979
|
-
|
|
2980
|
-
|
|
2981
|
-
"conten",
|
|
2982
|
-
"content"
|
|
2983
|
-
],
|
|
2984
|
-
"description": "Attributes to highlight\nBy default, all searchable attributes are highlighted.\nUse `*` to highlight all attributes or use an empty array `[]` to turn off highlighting.\nAttribute names are case-sensitive\nWith highlighting, strings that match the search query are surrounded by HTML tags defined by `highlightPreTag` and `highlightPostTag`.\nYou can use this to visually highlight matching parts of a search query in your UI\nFor more information, see [Highlighting and snippeting](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/highlighting-snippeting/js/).\n",
|
|
2985
|
-
"x-categories": [
|
|
2986
|
-
"Highlighting and Snippeting"
|
|
2987
|
-
]
|
|
2677
|
+
"example": ["author", "title", "conten", "content"],
|
|
2678
|
+
"description": "Attributes to highlight\nBy default, all searchable attributes are highlighted.\nUse `*` to highlight all attributes or use an empty array `[]` to turn off highlighting.\nAttribute names are case-sensitive\nWith highlighting, strings that match the search query are surrounded by HTML tags defined by `highlightPreTag` and `highlightPostTag`.\nYou can use this to visually highlight matching parts of a search query in your UI\nFor more information, see [Highlighting and snippeting](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/highlighting-snippeting/js).\n",
|
|
2679
|
+
"x-categories": ["Highlighting and Snippeting"]
|
|
2988
2680
|
},
|
|
2989
2681
|
"attributesToRetrieve": {
|
|
2990
2682
|
"type": "array",
|
|
2991
2683
|
"items": {
|
|
2992
2684
|
"type": "string"
|
|
2993
2685
|
},
|
|
2994
|
-
"example": [
|
|
2995
|
-
"author",
|
|
2996
|
-
"title",
|
|
2997
|
-
"content"
|
|
2998
|
-
],
|
|
2686
|
+
"example": ["author", "title", "content"],
|
|
2999
2687
|
"description": "Attributes to include in the API response\nTo reduce the size of your response, you can retrieve only some of the attributes.\nAttribute names are case-sensitive\n- `*` retrieves all attributes, except attributes included in the `customRanking` and `unretrievableAttributes` settings.\n- To retrieve all attributes except a specific one, prefix the attribute with a dash and combine it with the `*`: `[\"*\", \"-ATTRIBUTE\"]`.\n- The `objectID` attribute is always included.\n",
|
|
3000
|
-
"default": [
|
|
3001
|
-
|
|
3002
|
-
],
|
|
3003
|
-
"x-categories": [
|
|
3004
|
-
"Attributes"
|
|
3005
|
-
]
|
|
2688
|
+
"default": ["*"],
|
|
2689
|
+
"x-categories": ["Attributes"]
|
|
3006
2690
|
},
|
|
3007
2691
|
"attributesToSnippet": {
|
|
3008
2692
|
"type": "array",
|
|
3009
2693
|
"items": {
|
|
3010
2694
|
"type": "string"
|
|
3011
2695
|
},
|
|
3012
|
-
"example": [
|
|
3013
|
-
"content:80",
|
|
3014
|
-
"description"
|
|
3015
|
-
],
|
|
2696
|
+
"example": ["content:80", "description"],
|
|
3016
2697
|
"description": "Attributes for which to enable snippets.\nAttribute names are case-sensitive\nSnippets provide additional context to matched words.\nIf you enable snippets, they include 10 words, including the matched word.\nThe matched word will also be wrapped by HTML tags for highlighting.\nYou can adjust the number of words with the following notation: `ATTRIBUTE:NUMBER`,\nwhere `NUMBER` is the number of words to be extracted.\n",
|
|
3017
2698
|
"default": [],
|
|
3018
|
-
"x-categories": [
|
|
3019
|
-
"Highlighting and Snippeting"
|
|
3020
|
-
]
|
|
2699
|
+
"x-categories": ["Highlighting and Snippeting"]
|
|
3021
2700
|
},
|
|
3022
2701
|
"decompoundQuery": {
|
|
3023
2702
|
"type": "boolean",
|
|
3024
2703
|
"description": "Whether to split compound words in the query into their building blocks\nFor more information, see [Word segmentation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations/#splitting-compound-words).\nWord segmentation is supported for these languages: German, Dutch, Finnish, Swedish, and Norwegian.\nDecompounding doesn't work for words with [non-spacing mark Unicode characters](https://www.charactercodes.net/category/non-spacing_mark).\nFor example, `Gartenstühle` won't be decompounded if the `ü` consists of `u` (U+0075) and `◌̈` (U+0308).\n",
|
|
3025
2704
|
"default": true,
|
|
3026
|
-
"x-categories": [
|
|
3027
|
-
"Languages"
|
|
3028
|
-
]
|
|
2705
|
+
"x-categories": ["Languages"]
|
|
3029
2706
|
},
|
|
3030
2707
|
"disableExactOnAttributes": {
|
|
3031
2708
|
"type": "array",
|
|
3032
2709
|
"items": {
|
|
3033
2710
|
"type": "string"
|
|
3034
2711
|
},
|
|
3035
|
-
"example": [
|
|
3036
|
-
"description"
|
|
3037
|
-
],
|
|
2712
|
+
"example": ["description"],
|
|
3038
2713
|
"description": "Searchable attributes for which you want to [turn off the Exact ranking criterion](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/adjust-exact-settings/#turn-off-exact-for-some-attributes).\nAttribute names are case-sensitive\nThis can be useful for attributes with long values, where the likelihood of an exact match is high,\nsuch as product descriptions.\nTurning off the Exact ranking criterion for these attributes favors exact matching on other attributes.\nThis reduces the impact of individual attributes with a lot of content on ranking.\n",
|
|
3039
2714
|
"default": [],
|
|
3040
|
-
"x-categories": [
|
|
3041
|
-
"Query strategy"
|
|
3042
|
-
]
|
|
2715
|
+
"x-categories": ["Query strategy"]
|
|
3043
2716
|
},
|
|
3044
2717
|
"disableTypoToleranceOnAttributes": {
|
|
3045
2718
|
"type": "array",
|
|
3046
2719
|
"items": {
|
|
3047
2720
|
"type": "string"
|
|
3048
2721
|
},
|
|
3049
|
-
"example": [
|
|
3050
|
-
|
|
3051
|
-
],
|
|
3052
|
-
"description": "Attributes for which you want to turn off [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/).\nAttribute names are case-sensitive\nReturning only exact matches can help when\n- [Searching in hyphenated attributes](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/how-to/how-to-search-in-hyphenated-attributes/).\n- Reducing the number of matches when you have too many.\n This can happen with attributes that are long blocks of text, such as product descriptions\nConsider alternatives such as `disableTypoToleranceOnWords` or adding synonyms if your attributes have intentional unusual spellings that might look like typos.\n",
|
|
2722
|
+
"example": ["sku"],
|
|
2723
|
+
"description": "Attributes for which you want to turn off [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance).\nAttribute names are case-sensitive\nReturning only exact matches can help when\n- [Searching in hyphenated attributes](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/how-to/how-to-search-in-hyphenated-attributes).\n- Reducing the number of matches when you have too many.\n This can happen with attributes that are long blocks of text, such as product descriptions\nConsider alternatives such as `disableTypoToleranceOnWords` or adding synonyms if your attributes have intentional unusual spellings that might look like typos.\n",
|
|
3053
2724
|
"default": [],
|
|
3054
|
-
"x-categories": [
|
|
3055
|
-
"Typos"
|
|
3056
|
-
]
|
|
2725
|
+
"x-categories": ["Typos"]
|
|
3057
2726
|
},
|
|
3058
2727
|
"distinct": {
|
|
3059
2728
|
"description": "Determines how many records of a group are included in the search results.\n\nRecords with the same value for the `attributeForDistinct` attribute are considered a group.\nThe `distinct` setting controls how many members of the group are returned.\nThis is useful for [deduplication and grouping](https://www.algolia.com/doc/guides/managing-results/refine-results/grouping/#introducing-algolias-distinct-feature).\n\nThe `distinct` setting is ignored if `attributeForDistinct` is not set.\n",
|
|
@@ -3065,90 +2734,64 @@
|
|
|
3065
2734
|
},
|
|
3066
2735
|
{
|
|
3067
2736
|
"type": "integer",
|
|
3068
|
-
"description": "Number of members of a group of records to include in the search results.\n\n- Don't use `distinct > 1` for records that might be [promoted by rules](https://www.algolia.com/doc/guides/managing-results/rules/merchandising-and-promoting/how-to/promote-hits
|
|
2737
|
+
"description": "Number of members of a group of records to include in the search results.\n\n- Don't use `distinct > 1` for records that might be [promoted by rules](https://www.algolia.com/doc/guides/managing-results/rules/merchandising-and-promoting/how-to/promote-hits).\n The number of hits won't be correct and faceting won't work as expected.\n- With `distinct > 1`, the `hitsPerPage` parameter controls the number of returned groups.\n For example, with `hitsPerPage: 10` and `distinct: 2`, up to 20 records are returned.\n Likewise, the `nbHits` response attribute contains the number of returned groups.\n",
|
|
3069
2738
|
"minimum": 0,
|
|
3070
2739
|
"maximum": 4,
|
|
3071
2740
|
"default": 0
|
|
3072
2741
|
}
|
|
3073
2742
|
],
|
|
3074
|
-
"x-categories": [
|
|
3075
|
-
"Advanced"
|
|
3076
|
-
]
|
|
2743
|
+
"x-categories": ["Advanced"]
|
|
3077
2744
|
},
|
|
3078
2745
|
"SearchParams_enableABTest": {
|
|
3079
2746
|
"type": "boolean",
|
|
3080
2747
|
"description": "Whether to enable A/B testing for this search.",
|
|
3081
2748
|
"default": true,
|
|
3082
|
-
"x-categories": [
|
|
3083
|
-
"Advanced"
|
|
3084
|
-
]
|
|
2749
|
+
"x-categories": ["Advanced"]
|
|
3085
2750
|
},
|
|
3086
2751
|
"enablePersonalization": {
|
|
3087
2752
|
"type": "boolean",
|
|
3088
2753
|
"description": "Whether to enable Personalization.",
|
|
3089
2754
|
"default": false,
|
|
3090
|
-
"x-categories": [
|
|
3091
|
-
"Personalization"
|
|
3092
|
-
]
|
|
2755
|
+
"x-categories": ["Personalization"]
|
|
3093
2756
|
},
|
|
3094
2757
|
"IndexSettings_enableRules": {
|
|
3095
2758
|
"type": "boolean",
|
|
3096
2759
|
"description": "Whether to enable rules.",
|
|
3097
2760
|
"default": true,
|
|
3098
|
-
"x-categories": [
|
|
3099
|
-
"Rules"
|
|
3100
|
-
]
|
|
2761
|
+
"x-categories": ["Rules"]
|
|
3101
2762
|
},
|
|
3102
2763
|
"exactOnSingleWordQuery": {
|
|
3103
2764
|
"type": "string",
|
|
3104
|
-
"enum": [
|
|
3105
|
-
"attribute",
|
|
3106
|
-
"none",
|
|
3107
|
-
"word"
|
|
3108
|
-
],
|
|
2765
|
+
"enum": ["attribute", "none", "word"],
|
|
3109
2766
|
"description": "Determines how the [Exact ranking criterion](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/adjust-exact-settings/#turn-off-exact-for-some-attributes) is computed when the search query has only one word.\n\n- `attribute`.\n The Exact ranking criterion is 1 if the query word and attribute value are the same.\n For example, a search for \"road\" will match the value \"road\", but not \"road trip\".\n\n- `none`.\n The Exact ranking criterion is ignored on single-word searches.\n\n- `word`.\n The Exact ranking criterion is 1 if the query word is found in the attribute value.\n The query word must have at least 3 characters and must not be a stop word.\n Only exact matches will be highlighted,\n partial and prefix matches won't.\n",
|
|
3110
2767
|
"default": "attribute",
|
|
3111
|
-
"x-categories": [
|
|
3112
|
-
"Query strategy"
|
|
3113
|
-
]
|
|
2768
|
+
"x-categories": ["Query strategy"]
|
|
3114
2769
|
},
|
|
3115
2770
|
"SearchParams_getRankingInfo": {
|
|
3116
2771
|
"type": "boolean",
|
|
3117
2772
|
"description": "Whether the search response should include detailed ranking information.",
|
|
3118
2773
|
"default": false,
|
|
3119
|
-
"x-categories": [
|
|
3120
|
-
"Advanced"
|
|
3121
|
-
]
|
|
2774
|
+
"x-categories": ["Advanced"]
|
|
3122
2775
|
},
|
|
3123
2776
|
"highlightPostTag": {
|
|
3124
2777
|
"type": "string",
|
|
3125
2778
|
"description": "HTML tag to insert after the highlighted parts in all highlighted results and snippets.",
|
|
3126
2779
|
"default": "</em>",
|
|
3127
|
-
"x-categories": [
|
|
3128
|
-
"Highlighting and Snippeting"
|
|
3129
|
-
]
|
|
2780
|
+
"x-categories": ["Highlighting and Snippeting"]
|
|
3130
2781
|
},
|
|
3131
2782
|
"highlightPreTag": {
|
|
3132
2783
|
"type": "string",
|
|
3133
2784
|
"description": "HTML tag to insert before the highlighted parts in all highlighted results and snippets.",
|
|
3134
2785
|
"default": "<em>",
|
|
3135
|
-
"x-categories": [
|
|
3136
|
-
"Highlighting and Snippeting"
|
|
3137
|
-
]
|
|
2786
|
+
"x-categories": ["Highlighting and Snippeting"]
|
|
3138
2787
|
},
|
|
3139
2788
|
"booleanString": {
|
|
3140
2789
|
"type": "string",
|
|
3141
|
-
"enum": [
|
|
3142
|
-
"true",
|
|
3143
|
-
"false"
|
|
3144
|
-
]
|
|
2790
|
+
"enum": ["true", "false"]
|
|
3145
2791
|
},
|
|
3146
2792
|
"ignorePlurals": {
|
|
3147
2793
|
"description": "Treat singular, plurals, and other forms of declensions as equivalent.\nYou should only use this feature for the languages used in your index.\n",
|
|
3148
|
-
"example": [
|
|
3149
|
-
"ca",
|
|
3150
|
-
"es"
|
|
3151
|
-
],
|
|
2794
|
+
"example": ["ca", "es"],
|
|
3152
2795
|
"oneOf": [
|
|
3153
2796
|
{
|
|
3154
2797
|
"type": "array",
|
|
@@ -3166,9 +2809,7 @@
|
|
|
3166
2809
|
"default": false
|
|
3167
2810
|
}
|
|
3168
2811
|
],
|
|
3169
|
-
"x-categories": [
|
|
3170
|
-
"Languages"
|
|
3171
|
-
]
|
|
2812
|
+
"x-categories": ["Languages"]
|
|
3172
2813
|
},
|
|
3173
2814
|
"minProximity": {
|
|
3174
2815
|
"type": "integer",
|
|
@@ -3176,40 +2817,29 @@
|
|
|
3176
2817
|
"maximum": 7,
|
|
3177
2818
|
"description": "Minimum proximity score for two matching words\nThis adjusts the [Proximity ranking criterion](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria/#proximity)\nby equally scoring matches that are farther apart\nFor example, if `minProximity` is 2, neighboring matches and matches with one word between them would have the same score.\n",
|
|
3178
2819
|
"default": 1,
|
|
3179
|
-
"x-categories": [
|
|
3180
|
-
"Advanced"
|
|
3181
|
-
]
|
|
2820
|
+
"x-categories": ["Advanced"]
|
|
3182
2821
|
},
|
|
3183
2822
|
"minWordSizefor1Typo": {
|
|
3184
2823
|
"type": "integer",
|
|
3185
2824
|
"description": "Minimum number of characters a word in the search query must contain to accept matches with [one typo](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/in-depth/configuring-typo-tolerance/#configuring-word-length-for-typos).",
|
|
3186
2825
|
"default": 4,
|
|
3187
|
-
"x-categories": [
|
|
3188
|
-
"Typos"
|
|
3189
|
-
]
|
|
2826
|
+
"x-categories": ["Typos"]
|
|
3190
2827
|
},
|
|
3191
2828
|
"minWordSizefor2Typos": {
|
|
3192
2829
|
"type": "integer",
|
|
3193
2830
|
"description": "Minimum number of characters a word in the search query must contain to accept matches with [two typos](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/in-depth/configuring-typo-tolerance/#configuring-word-length-for-typos).",
|
|
3194
2831
|
"default": 8,
|
|
3195
|
-
"x-categories": [
|
|
3196
|
-
"Typos"
|
|
3197
|
-
]
|
|
2832
|
+
"x-categories": ["Typos"]
|
|
3198
2833
|
},
|
|
3199
2834
|
"optionalWordsArray": {
|
|
3200
2835
|
"type": "array",
|
|
3201
2836
|
"items": {
|
|
3202
2837
|
"type": "string"
|
|
3203
2838
|
},
|
|
3204
|
-
"example": [
|
|
3205
|
-
"blue",
|
|
3206
|
-
"iphone case"
|
|
3207
|
-
],
|
|
2839
|
+
"example": ["blue", "iphone case"],
|
|
3208
2840
|
"description": "List of [optional words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/#creating-a-list-of-optional-words).",
|
|
3209
2841
|
"default": [],
|
|
3210
|
-
"x-categories": [
|
|
3211
|
-
"Query strategy"
|
|
3212
|
-
]
|
|
2842
|
+
"x-categories": ["Query strategy"]
|
|
3213
2843
|
},
|
|
3214
2844
|
"optionalWords": {
|
|
3215
2845
|
"description": "Words that should be considered optional when found in the query.\n\nBy default, records must match all words in the search query to be included in the search results.\nAdding optional words can help to increase the number of search results by running an additional search query that doesn't include the optional words.\nFor example, if the search query is \"action video\" and \"video\" is an optional word,\nthe search engine runs two queries. One for \"action video\" and one for \"action\".\nRecords that match all words are ranked higher.\n\nFor a search query with 4 or more words **and** all its words are optional,\nthe number of matched words required for a record to be included in the search results increases for every 1,000 records:\n\n- If `optionalWords` has less than 10 words, the required number of matched words increases by 1:\n results 1 to 1,000 require 1 matched word, results 1,001 to 2000 need 2 matched words.\n- If `optionalWords` has 10 or more words, the number of required matched words increases by the number of optional words divided by 5 (rounded down).\n For example, with 18 optional words: results 1 to 1,000 require 1 matched word, results 1,001 to 2000 need 4 matched words.\n\nFor more information, see [Optional words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/#creating-a-list-of-optional-words).\n",
|
|
@@ -3229,9 +2859,7 @@
|
|
|
3229
2859
|
"type": "boolean",
|
|
3230
2860
|
"description": "Whether to include this search when calculating processing-time percentiles.",
|
|
3231
2861
|
"default": true,
|
|
3232
|
-
"x-categories": [
|
|
3233
|
-
"Advanced"
|
|
3234
|
-
]
|
|
2862
|
+
"x-categories": ["Advanced"]
|
|
3235
2863
|
},
|
|
3236
2864
|
"personalizationImpact": {
|
|
3237
2865
|
"type": "integer",
|
|
@@ -3239,29 +2867,18 @@
|
|
|
3239
2867
|
"default": 100,
|
|
3240
2868
|
"minimum": 0,
|
|
3241
2869
|
"maximum": 100,
|
|
3242
|
-
"x-categories": [
|
|
3243
|
-
"Personalization"
|
|
3244
|
-
]
|
|
2870
|
+
"x-categories": ["Personalization"]
|
|
3245
2871
|
},
|
|
3246
2872
|
"queryType": {
|
|
3247
2873
|
"type": "string",
|
|
3248
|
-
"enum": [
|
|
3249
|
-
|
|
3250
|
-
"prefixAll",
|
|
3251
|
-
"prefixNone"
|
|
3252
|
-
],
|
|
3253
|
-
"description": "Determines if and how query words are interpreted as prefixes.\n\nBy default, only the last query word is treated as a prefix (`prefixLast`).\nTo turn off prefix search, use `prefixNone`.\nAvoid `prefixAll`, which treats all query words as prefixes.\nThis might lead to counterintuitive results and makes your search slower.\n\nFor more information, see [Prefix searching](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/prefix-searching/).\n",
|
|
2874
|
+
"enum": ["prefixLast", "prefixAll", "prefixNone"],
|
|
2875
|
+
"description": "Determines if and how query words are interpreted as prefixes.\n\nBy default, only the last query word is treated as a prefix (`prefixLast`).\nTo turn off prefix search, use `prefixNone`.\nAvoid `prefixAll`, which treats all query words as prefixes.\nThis might lead to counterintuitive results and makes your search slower.\n\nFor more information, see [Prefix searching](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/prefix-searching).\n",
|
|
3254
2876
|
"default": "prefixLast",
|
|
3255
|
-
"x-categories": [
|
|
3256
|
-
"Query strategy"
|
|
3257
|
-
]
|
|
2877
|
+
"x-categories": ["Query strategy"]
|
|
3258
2878
|
},
|
|
3259
2879
|
"removeStopWords": {
|
|
3260
2880
|
"description": "Removes stop words from the search query.\n\nStop words are common words like articles, conjunctions, prepositions, or pronouns that have little or no meaning on their own.\nIn English, \"the\", \"a\", or \"and\" are stop words.\n\nYou should only use this feature for the languages used in your index.\n",
|
|
3261
|
-
"example": [
|
|
3262
|
-
"ca",
|
|
3263
|
-
"es"
|
|
3264
|
-
],
|
|
2881
|
+
"example": ["ca", "es"],
|
|
3265
2882
|
"oneOf": [
|
|
3266
2883
|
{
|
|
3267
2884
|
"type": "array",
|
|
@@ -3276,32 +2893,21 @@
|
|
|
3276
2893
|
"description": "If true, stop words are removed for all languages you included in `queryLanguages`, or for all supported languages, if `queryLanguages` is empty.\nIf false, stop words are not removed.\n"
|
|
3277
2894
|
}
|
|
3278
2895
|
],
|
|
3279
|
-
"x-categories": [
|
|
3280
|
-
"Languages"
|
|
3281
|
-
]
|
|
2896
|
+
"x-categories": ["Languages"]
|
|
3282
2897
|
},
|
|
3283
2898
|
"removeWordsIfNoResults": {
|
|
3284
2899
|
"type": "string",
|
|
3285
|
-
"enum": [
|
|
3286
|
-
"none",
|
|
3287
|
-
"lastWords",
|
|
3288
|
-
"firstWords",
|
|
3289
|
-
"allOptional"
|
|
3290
|
-
],
|
|
2900
|
+
"enum": ["none", "lastWords", "firstWords", "allOptional"],
|
|
3291
2901
|
"example": "firstWords",
|
|
3292
|
-
"description": "Strategy for removing words from the query when it doesn't return any results.\nThis helps to avoid returning empty search results.\n\n- `none`.\n No words are removed when a query doesn't return results.\n\n- `lastWords`.\n Treat the last (then second to last, then third to last) word as optional,\n until there are results or at most 5 words have been removed.\n\n- `firstWords`.\n Treat the first (then second, then third) word as optional,\n until there are results or at most 5 words have been removed.\n\n- `allOptional`.\n Treat all words as optional.\n\nFor more information, see [Remove words to improve results](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/in-depth/why-use-remove-words-if-no-results
|
|
2902
|
+
"description": "Strategy for removing words from the query when it doesn't return any results.\nThis helps to avoid returning empty search results.\n\n- `none`.\n No words are removed when a query doesn't return results.\n\n- `lastWords`.\n Treat the last (then second to last, then third to last) word as optional,\n until there are results or at most 5 words have been removed.\n\n- `firstWords`.\n Treat the first (then second, then third) word as optional,\n until there are results or at most 5 words have been removed.\n\n- `allOptional`.\n Treat all words as optional.\n\nFor more information, see [Remove words to improve results](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/in-depth/why-use-remove-words-if-no-results).\n",
|
|
3293
2903
|
"default": "none",
|
|
3294
|
-
"x-categories": [
|
|
3295
|
-
"Query strategy"
|
|
3296
|
-
]
|
|
2904
|
+
"x-categories": ["Query strategy"]
|
|
3297
2905
|
},
|
|
3298
2906
|
"replaceSynonymsInHighlight": {
|
|
3299
2907
|
"type": "boolean",
|
|
3300
2908
|
"description": "Whether to replace a highlighted word with the matched synonym\nBy default, the original words are highlighted even if a synonym matches.\nFor example, with `home` as a synonym for `house` and a search for `home`,\nrecords matching either \"home\" or \"house\" are included in the search results,\nand either \"home\" or \"house\" are highlighted\nWith `replaceSynonymsInHighlight` set to `true`, a search for `home` still matches the same records,\nbut all occurrences of \"house\" are replaced by \"home\" in the highlighted response.\n",
|
|
3301
2909
|
"default": false,
|
|
3302
|
-
"x-categories": [
|
|
3303
|
-
"Highlighting and Snippeting"
|
|
3304
|
-
]
|
|
2910
|
+
"x-categories": ["Highlighting and Snippeting"]
|
|
3305
2911
|
},
|
|
3306
2912
|
"responseFields": {
|
|
3307
2913
|
"type": "array",
|
|
@@ -3309,35 +2915,24 @@
|
|
|
3309
2915
|
"type": "string"
|
|
3310
2916
|
},
|
|
3311
2917
|
"description": "Properties to include in the API response of search and browse requests\nBy default, all response properties are included.\nTo reduce the response size, you can select which properties should be included\nAn empty list may lead to an empty API response (except properties you can't exclude)\nYou can't exclude these properties:\n`message`, `warning`, `cursor`, `abTestVariantID`,\nor any property added by setting `getRankingInfo` to true\nYour search depends on the `hits` field. If you omit this field, searches won't return any results.\nYour UI might also depend on other properties, for example, for pagination.\nBefore restricting the response size, check the impact on your search experience.\n",
|
|
3312
|
-
"default": [
|
|
3313
|
-
|
|
3314
|
-
],
|
|
3315
|
-
"x-categories": [
|
|
3316
|
-
"Advanced"
|
|
3317
|
-
]
|
|
2918
|
+
"default": ["*"],
|
|
2919
|
+
"x-categories": ["Advanced"]
|
|
3318
2920
|
},
|
|
3319
2921
|
"restrictHighlightAndSnippetArrays": {
|
|
3320
2922
|
"type": "boolean",
|
|
3321
2923
|
"description": "Whether to restrict highlighting and snippeting to items that at least partially matched the search query.\nBy default, all items are highlighted and snippeted.\n",
|
|
3322
2924
|
"default": false,
|
|
3323
|
-
"x-categories": [
|
|
3324
|
-
"Highlighting and Snippeting"
|
|
3325
|
-
]
|
|
2925
|
+
"x-categories": ["Highlighting and Snippeting"]
|
|
3326
2926
|
},
|
|
3327
2927
|
"restrictSearchableAttributes": {
|
|
3328
2928
|
"type": "array",
|
|
3329
2929
|
"items": {
|
|
3330
2930
|
"type": "string"
|
|
3331
2931
|
},
|
|
3332
|
-
"example": [
|
|
3333
|
-
"title",
|
|
3334
|
-
"author"
|
|
3335
|
-
],
|
|
2932
|
+
"example": ["title", "author"],
|
|
3336
2933
|
"description": "Restricts a search to a subset of your searchable attributes.\nAttribute names are case-sensitive.\n",
|
|
3337
2934
|
"default": [],
|
|
3338
|
-
"x-categories": [
|
|
3339
|
-
"Filtering"
|
|
3340
|
-
]
|
|
2935
|
+
"x-categories": ["Filtering"]
|
|
3341
2936
|
},
|
|
3342
2937
|
"SearchParams_ruleContexts": {
|
|
3343
2938
|
"type": "array",
|
|
@@ -3346,42 +2941,29 @@
|
|
|
3346
2941
|
},
|
|
3347
2942
|
"description": "Assigns a rule context to the search query\n[Rule contexts](https://www.algolia.com/doc/guides/managing-results/rules/rules-overview/how-to/customize-search-results-by-platform/#whats-a-context) are strings that you can use to trigger matching rules.\n",
|
|
3348
2943
|
"default": [],
|
|
3349
|
-
"example": [
|
|
3350
|
-
|
|
3351
|
-
],
|
|
3352
|
-
"x-categories": [
|
|
3353
|
-
"Rules"
|
|
3354
|
-
]
|
|
2944
|
+
"example": ["mobile"],
|
|
2945
|
+
"x-categories": ["Rules"]
|
|
3355
2946
|
},
|
|
3356
2947
|
"snippetEllipsisText": {
|
|
3357
2948
|
"type": "string",
|
|
3358
2949
|
"description": "String used as an ellipsis indicator when a snippet is truncated.",
|
|
3359
2950
|
"default": "…",
|
|
3360
|
-
"x-categories": [
|
|
3361
|
-
"Highlighting and Snippeting"
|
|
3362
|
-
]
|
|
2951
|
+
"x-categories": ["Highlighting and Snippeting"]
|
|
3363
2952
|
},
|
|
3364
2953
|
"synonyms": {
|
|
3365
2954
|
"type": "boolean",
|
|
3366
2955
|
"description": "Whether to take into account an index's synonyms for this search.",
|
|
3367
2956
|
"default": true,
|
|
3368
|
-
"x-categories": [
|
|
3369
|
-
"Advanced"
|
|
3370
|
-
]
|
|
2957
|
+
"x-categories": ["Advanced"]
|
|
3371
2958
|
},
|
|
3372
2959
|
"typoToleranceEnum": {
|
|
3373
2960
|
"type": "string",
|
|
3374
2961
|
"title": "typo tolerance",
|
|
3375
2962
|
"description": "- `min`. Return matches with the lowest number of typos.\n For example, if you have matches without typos, only include those.\n But if there are no matches without typos (with 1 typo), include matches with 1 typo (2 typos).\n- `strict`. Return matches with the two lowest numbers of typos.\n With `strict`, the Typo ranking criterion is applied first in the `ranking` setting.\n",
|
|
3376
|
-
"enum": [
|
|
3377
|
-
"min",
|
|
3378
|
-
"strict",
|
|
3379
|
-
"true",
|
|
3380
|
-
"false"
|
|
3381
|
-
]
|
|
2963
|
+
"enum": ["min", "strict", "true", "false"]
|
|
3382
2964
|
},
|
|
3383
2965
|
"typoTolerance": {
|
|
3384
|
-
"description": "Whether [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance
|
|
2966
|
+
"description": "Whether [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance) is enabled and how it is applied.\n\nIf typo tolerance is true, `min`, or `strict`, [word splitting and concatenation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/splitting-and-concatenation) are also active.\n",
|
|
3385
2967
|
"oneOf": [
|
|
3386
2968
|
{
|
|
3387
2969
|
"type": "boolean",
|
|
@@ -3392,9 +2974,7 @@
|
|
|
3392
2974
|
"$ref": "#/components/schemas/typoToleranceEnum"
|
|
3393
2975
|
}
|
|
3394
2976
|
],
|
|
3395
|
-
"x-categories": [
|
|
3396
|
-
"Typos"
|
|
3397
|
-
]
|
|
2977
|
+
"x-categories": ["Typos"]
|
|
3398
2978
|
},
|
|
3399
2979
|
"baseInjectionQueryParameters": {
|
|
3400
2980
|
"title": "Composition common query parameters between main and injected items as object",
|
|
@@ -3548,9 +3128,7 @@
|
|
|
3548
3128
|
"type": "boolean",
|
|
3549
3129
|
"description": "Whether faceting should be applied after deduplication with `distinct`\nThis leads to accurate facet counts when using faceting in combination with `distinct`.\nIt's usually better to use `afterDistinct` modifiers in the `attributesForFaceting` setting,\nas `facetingAfterDistinct` only computes correct facet counts if all records have the same facet values for the `attributeForDistinct`.\n",
|
|
3550
3130
|
"default": false,
|
|
3551
|
-
"x-categories": [
|
|
3552
|
-
"Faceting"
|
|
3553
|
-
]
|
|
3131
|
+
"x-categories": ["Faceting"]
|
|
3554
3132
|
},
|
|
3555
3133
|
"properties-facets": {
|
|
3556
3134
|
"type": "array",
|
|
@@ -3559,37 +3137,27 @@
|
|
|
3559
3137
|
},
|
|
3560
3138
|
"description": "Facets for which to retrieve facet values that match the search criteria and the number of matching facet values\nTo retrieve all facets, use the wildcard character `*`.\nFor more information, see [facets](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#contextual-facet-values-and-counts).\n",
|
|
3561
3139
|
"default": [],
|
|
3562
|
-
"example": [
|
|
3563
|
-
|
|
3564
|
-
],
|
|
3565
|
-
"x-categories": [
|
|
3566
|
-
"Faceting"
|
|
3567
|
-
]
|
|
3140
|
+
"example": ["*"],
|
|
3141
|
+
"x-categories": ["Faceting"]
|
|
3568
3142
|
},
|
|
3569
3143
|
"maxValuesPerFacet": {
|
|
3570
3144
|
"type": "integer",
|
|
3571
3145
|
"description": "Maximum number of facet values to return for each facet.",
|
|
3572
3146
|
"default": 100,
|
|
3573
3147
|
"maximum": 1000,
|
|
3574
|
-
"x-categories": [
|
|
3575
|
-
"Faceting"
|
|
3576
|
-
]
|
|
3148
|
+
"x-categories": ["Faceting"]
|
|
3577
3149
|
},
|
|
3578
3150
|
"sortFacetValuesBy": {
|
|
3579
3151
|
"type": "string",
|
|
3580
|
-
"description": "Order in which to retrieve facet values\n- `count`.\n Facet values are retrieved by decreasing count.\n The count is the number of matching records containing this facet value\n- `alpha`.\n Retrieve facet values alphabetically\nThis setting doesn't influence how facet values are displayed in your UI (see `renderingContent`).\nFor more information, see [facet value display](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/facet-display/js
|
|
3152
|
+
"description": "Order in which to retrieve facet values\n- `count`.\n Facet values are retrieved by decreasing count.\n The count is the number of matching records containing this facet value\n- `alpha`.\n Retrieve facet values alphabetically\nThis setting doesn't influence how facet values are displayed in your UI (see `renderingContent`).\nFor more information, see [facet value display](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/facet-display/js).\n",
|
|
3581
3153
|
"default": "count",
|
|
3582
|
-
"x-categories": [
|
|
3583
|
-
"Faceting"
|
|
3584
|
-
]
|
|
3154
|
+
"x-categories": ["Faceting"]
|
|
3585
3155
|
},
|
|
3586
3156
|
"sumOrFiltersScores": {
|
|
3587
3157
|
"type": "boolean",
|
|
3588
3158
|
"description": "Whether to sum all filter scores\nIf true, all filter scores are summed.\nOtherwise, the maximum filter score is kept.\nFor more information, see [filter scores](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering/in-depth/filter-scoring/#accumulating-scores-with-sumorfiltersscores).\n",
|
|
3589
3159
|
"default": false,
|
|
3590
|
-
"x-categories": [
|
|
3591
|
-
"Filtering"
|
|
3592
|
-
]
|
|
3160
|
+
"x-categories": ["Filtering"]
|
|
3593
3161
|
},
|
|
3594
3162
|
"mainInjectionQueryParameters": {
|
|
3595
3163
|
"title": "Composition Main Injection Query parameters as object",
|
|
@@ -3645,20 +3213,13 @@
|
|
|
3645
3213
|
"$ref": "#/components/schemas/baseInjectionQueryParameters"
|
|
3646
3214
|
}
|
|
3647
3215
|
},
|
|
3648
|
-
"required": [
|
|
3649
|
-
"index"
|
|
3650
|
-
]
|
|
3216
|
+
"required": ["index"]
|
|
3651
3217
|
}
|
|
3652
3218
|
},
|
|
3653
|
-
"required": [
|
|
3654
|
-
"search"
|
|
3655
|
-
]
|
|
3219
|
+
"required": ["search"]
|
|
3656
3220
|
},
|
|
3657
3221
|
"externalOrdering": {
|
|
3658
|
-
"enum": [
|
|
3659
|
-
"default",
|
|
3660
|
-
"userDefined"
|
|
3661
|
-
],
|
|
3222
|
+
"enum": ["default", "userDefined"],
|
|
3662
3223
|
"default": "default"
|
|
3663
3224
|
},
|
|
3664
3225
|
"ExternalSource": {
|
|
@@ -3684,14 +3245,10 @@
|
|
|
3684
3245
|
"$ref": "#/components/schemas/externalOrdering"
|
|
3685
3246
|
}
|
|
3686
3247
|
},
|
|
3687
|
-
"required": [
|
|
3688
|
-
"index"
|
|
3689
|
-
]
|
|
3248
|
+
"required": ["index"]
|
|
3690
3249
|
}
|
|
3691
3250
|
},
|
|
3692
|
-
"required": [
|
|
3693
|
-
"external"
|
|
3694
|
-
]
|
|
3251
|
+
"required": ["external"]
|
|
3695
3252
|
},
|
|
3696
3253
|
"injectedItemSource": {
|
|
3697
3254
|
"oneOf": [
|
|
@@ -3749,12 +3306,14 @@
|
|
|
3749
3306
|
}
|
|
3750
3307
|
}
|
|
3751
3308
|
},
|
|
3752
|
-
"required": [
|
|
3753
|
-
|
|
3754
|
-
|
|
3755
|
-
|
|
3756
|
-
|
|
3757
|
-
|
|
3309
|
+
"required": ["key", "source", "position", "length"]
|
|
3310
|
+
},
|
|
3311
|
+
"dedupPositioning": {
|
|
3312
|
+
"type": "string",
|
|
3313
|
+
"enum": ["highest", "highestInjected"],
|
|
3314
|
+
"description": "Deduplication positioning configures how a duplicate result should be resolved between an injected item and main search results.\nCurrent configuration supports:\n- 'highest': always select the item in the highest position, and remove duplicates that appear lower in the results.\n- 'highestInjected': duplicate result will be moved to its highest possible injected position, but not higher. \n If a duplicate appears higher in main search results, it will be removed to stay it's intended group position (which could be lower than main).\n",
|
|
3315
|
+
"example": "highest",
|
|
3316
|
+
"default": "highestInjected"
|
|
3758
3317
|
},
|
|
3759
3318
|
"compositionBehavior": {
|
|
3760
3319
|
"type": "object",
|
|
@@ -3789,19 +3348,13 @@
|
|
|
3789
3348
|
"$ref": "#/components/schemas/mainInjectionQueryParameters"
|
|
3790
3349
|
}
|
|
3791
3350
|
},
|
|
3792
|
-
"required": [
|
|
3793
|
-
"index"
|
|
3794
|
-
]
|
|
3351
|
+
"required": ["index"]
|
|
3795
3352
|
}
|
|
3796
3353
|
},
|
|
3797
|
-
"required": [
|
|
3798
|
-
"search"
|
|
3799
|
-
]
|
|
3354
|
+
"required": ["search"]
|
|
3800
3355
|
}
|
|
3801
3356
|
},
|
|
3802
|
-
"required": [
|
|
3803
|
-
"source"
|
|
3804
|
-
]
|
|
3357
|
+
"required": ["source"]
|
|
3805
3358
|
},
|
|
3806
3359
|
"injectedItems": {
|
|
3807
3360
|
"type": "array",
|
|
@@ -3811,16 +3364,24 @@
|
|
|
3811
3364
|
"items": {
|
|
3812
3365
|
"$ref": "#/components/schemas/injectedItem"
|
|
3813
3366
|
}
|
|
3367
|
+
},
|
|
3368
|
+
"deduplication": {
|
|
3369
|
+
"title": "deduplication",
|
|
3370
|
+
"type": "object",
|
|
3371
|
+
"additionalProperties": false,
|
|
3372
|
+
"description": "Deduplication configures the methods used to resolve duplicate items between main search results and injected group results.",
|
|
3373
|
+
"properties": {
|
|
3374
|
+
"positioning": {
|
|
3375
|
+
"$ref": "#/components/schemas/dedupPositioning"
|
|
3376
|
+
}
|
|
3377
|
+
},
|
|
3378
|
+
"required": ["positioning"]
|
|
3814
3379
|
}
|
|
3815
3380
|
},
|
|
3816
|
-
"required": [
|
|
3817
|
-
"main"
|
|
3818
|
-
]
|
|
3381
|
+
"required": ["main"]
|
|
3819
3382
|
}
|
|
3820
3383
|
},
|
|
3821
|
-
"required": [
|
|
3822
|
-
"injection"
|
|
3823
|
-
]
|
|
3384
|
+
"required": ["injection"]
|
|
3824
3385
|
},
|
|
3825
3386
|
"composition": {
|
|
3826
3387
|
"type": "object",
|
|
@@ -3843,11 +3404,7 @@
|
|
|
3843
3404
|
"$ref": "#/components/schemas/compositionBehavior"
|
|
3844
3405
|
}
|
|
3845
3406
|
},
|
|
3846
|
-
"required": [
|
|
3847
|
-
"objectID",
|
|
3848
|
-
"behavior",
|
|
3849
|
-
"name"
|
|
3850
|
-
]
|
|
3407
|
+
"required": ["objectID", "behavior", "name"]
|
|
3851
3408
|
},
|
|
3852
3409
|
"listCompositionsResponse": {
|
|
3853
3410
|
"type": "object",
|
|
@@ -3881,26 +3438,17 @@
|
|
|
3881
3438
|
"example": 200
|
|
3882
3439
|
}
|
|
3883
3440
|
},
|
|
3884
|
-
"required": [
|
|
3885
|
-
"hitsPerPage",
|
|
3886
|
-
"items",
|
|
3887
|
-
"nbHits",
|
|
3888
|
-
"nbPages",
|
|
3889
|
-
"page"
|
|
3890
|
-
]
|
|
3441
|
+
"required": ["hitsPerPage", "items", "nbHits", "nbPages", "page"]
|
|
3891
3442
|
},
|
|
3892
3443
|
"taskID": {
|
|
3893
3444
|
"type": "integer",
|
|
3894
3445
|
"format": "int64",
|
|
3895
3446
|
"example": 1514562690001,
|
|
3896
|
-
"description": "Unique identifier of a task.\n\nA successful API response means that a task was added to a queue
|
|
3447
|
+
"description": "Unique identifier of a task.\n\nA successful API response means that a task was added to a queue.\nIt might not run immediately.\nYou can check the task's progress with the [`task` operation](https://www.algolia.com/doc/rest-api/search/get-task) and this task ID.\n"
|
|
3897
3448
|
},
|
|
3898
3449
|
"action": {
|
|
3899
3450
|
"type": "string",
|
|
3900
|
-
"enum": [
|
|
3901
|
-
"upsert",
|
|
3902
|
-
"delete"
|
|
3903
|
-
],
|
|
3451
|
+
"enum": ["upsert", "delete"],
|
|
3904
3452
|
"description": "Type of Composition Batch operation."
|
|
3905
3453
|
},
|
|
3906
3454
|
"deleteCompositionAction": {
|
|
@@ -3912,9 +3460,7 @@
|
|
|
3912
3460
|
"$ref": "#/components/schemas/compositionObjectID"
|
|
3913
3461
|
}
|
|
3914
3462
|
},
|
|
3915
|
-
"required": [
|
|
3916
|
-
"objectID"
|
|
3917
|
-
]
|
|
3463
|
+
"required": ["objectID"]
|
|
3918
3464
|
},
|
|
3919
3465
|
"batchCompositionAction": {
|
|
3920
3466
|
"oneOf": [
|
|
@@ -3939,12 +3485,7 @@
|
|
|
3939
3485
|
"anchoring": {
|
|
3940
3486
|
"type": "string",
|
|
3941
3487
|
"description": "Which part of the search query the pattern should match:\n\n- `startsWith`. The pattern must match the beginning of the query.\n- `endsWith`. The pattern must match the end of the query.\n- `is`. The pattern must match the query exactly.\n- `contains`. The pattern must match anywhere in the query.\n\nEmpty queries are only allowed as patterns with `anchoring: is`.\n",
|
|
3942
|
-
"enum": [
|
|
3943
|
-
"is",
|
|
3944
|
-
"startsWith",
|
|
3945
|
-
"endsWith",
|
|
3946
|
-
"contains"
|
|
3947
|
-
]
|
|
3488
|
+
"enum": ["is", "startsWith", "endsWith", "contains"]
|
|
3948
3489
|
},
|
|
3949
3490
|
"context": {
|
|
3950
3491
|
"type": "string",
|
|
@@ -4016,9 +3557,7 @@
|
|
|
4016
3557
|
"$ref": "#/components/schemas/compositionBehavior"
|
|
4017
3558
|
}
|
|
4018
3559
|
},
|
|
4019
|
-
"required": [
|
|
4020
|
-
"behavior"
|
|
4021
|
-
]
|
|
3560
|
+
"required": ["behavior"]
|
|
4022
3561
|
},
|
|
4023
3562
|
"description": {
|
|
4024
3563
|
"type": "string",
|
|
@@ -4043,16 +3582,10 @@
|
|
|
4043
3582
|
"items": {
|
|
4044
3583
|
"type": "string"
|
|
4045
3584
|
},
|
|
4046
|
-
"example": [
|
|
4047
|
-
"conditional"
|
|
4048
|
-
]
|
|
3585
|
+
"example": ["conditional"]
|
|
4049
3586
|
}
|
|
4050
3587
|
},
|
|
4051
|
-
"required": [
|
|
4052
|
-
"objectID",
|
|
4053
|
-
"conditions",
|
|
4054
|
-
"consequence"
|
|
4055
|
-
]
|
|
3588
|
+
"required": ["objectID", "conditions", "consequence"]
|
|
4056
3589
|
},
|
|
4057
3590
|
"deleteCompositionRuleAction": {
|
|
4058
3591
|
"type": "object",
|
|
@@ -4063,9 +3596,7 @@
|
|
|
4063
3596
|
"$ref": "#/components/schemas/compositionRuleObjectID"
|
|
4064
3597
|
}
|
|
4065
3598
|
},
|
|
4066
|
-
"required": [
|
|
4067
|
-
"objectID"
|
|
4068
|
-
]
|
|
3599
|
+
"required": ["objectID"]
|
|
4069
3600
|
},
|
|
4070
3601
|
"rulesBatchCompositionAction": {
|
|
4071
3602
|
"oneOf": [
|
|
@@ -4085,21 +3616,18 @@
|
|
|
4085
3616
|
"parameters_page": {
|
|
4086
3617
|
"type": "integer",
|
|
4087
3618
|
"minimum": 0,
|
|
4088
|
-
"description": "Requested page of the API response.\n\nAlgolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js
|
|
3619
|
+
"description": "Requested page of the API response.\n\nAlgolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js)).\n\n- `hitsPerPage`: sets the number of search results (_hits_) displayed per page.\n- `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.\n\nFor example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.\n"
|
|
4089
3620
|
},
|
|
4090
3621
|
"parameters_hitsPerPage": {
|
|
4091
3622
|
"type": "integer",
|
|
4092
3623
|
"default": 20,
|
|
4093
3624
|
"minimum": 1,
|
|
4094
3625
|
"maximum": 1000,
|
|
4095
|
-
"description": "Maximum number of hits per page.\n\nAlgolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js
|
|
3626
|
+
"description": "Maximum number of hits per page.\n\nAlgolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js)).\n\n- `hitsPerPage`: sets the number of search results (_hits_) displayed per page.\n- `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.\n\nFor example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.\n"
|
|
4096
3627
|
},
|
|
4097
3628
|
"taskStatus": {
|
|
4098
3629
|
"type": "string",
|
|
4099
|
-
"enum": [
|
|
4100
|
-
"published",
|
|
4101
|
-
"notPublished"
|
|
4102
|
-
],
|
|
3630
|
+
"enum": ["published", "notPublished"],
|
|
4103
3631
|
"description": "Task status, `published` if the task is completed, `notPublished` otherwise."
|
|
4104
3632
|
},
|
|
4105
3633
|
"GetTaskResponse": {
|
|
@@ -4111,9 +3639,7 @@
|
|
|
4111
3639
|
"$ref": "#/components/schemas/taskStatus"
|
|
4112
3640
|
}
|
|
4113
3641
|
},
|
|
4114
|
-
"required": [
|
|
4115
|
-
"status"
|
|
4116
|
-
]
|
|
3642
|
+
"required": ["status"]
|
|
4117
3643
|
}
|
|
4118
3644
|
},
|
|
4119
3645
|
"responses": {
|
|
@@ -4182,12 +3708,7 @@
|
|
|
4182
3708
|
"x-tagGroups": [
|
|
4183
3709
|
{
|
|
4184
3710
|
"name": "Composition",
|
|
4185
|
-
"tags": [
|
|
4186
|
-
"Search",
|
|
4187
|
-
"Compositions",
|
|
4188
|
-
"Composition Rules",
|
|
4189
|
-
"Advanced"
|
|
4190
|
-
]
|
|
3711
|
+
"tags": ["Search", "Compositions", "Composition Rules", "Advanced"]
|
|
4191
3712
|
}
|
|
4192
3713
|
]
|
|
4193
|
-
}
|
|
3714
|
+
}
|