@algolia/n8n-nodes-algolia 0.7.0 → 0.8.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 +74 -13
- package/dist/credentials/AlgoliaApi.credentials.js +1 -41
- package/dist/nodes/Algolia/Algolia.node.js +854 -17921
- package/package.json +10 -11
- package/dist/nodes/Algolia/specs/abtesting-v3.json +0 -1589
- package/dist/nodes/Algolia/specs/abtesting.json +0 -1493
- package/dist/nodes/Algolia/specs/advanced-personalization.json +0 -1493
- package/dist/nodes/Algolia/specs/analytics.json +0 -2879
- package/dist/nodes/Algolia/specs/composition.json +0 -3714
- package/dist/nodes/Algolia/specs/crawler.json +0 -2999
- package/dist/nodes/Algolia/specs/ingestion.json +0 -5621
- package/dist/nodes/Algolia/specs/insights.json +0 -1677
- package/dist/nodes/Algolia/specs/monitoring.json +0 -1223
- package/dist/nodes/Algolia/specs/personalization.json +0 -666
- package/dist/nodes/Algolia/specs/query-suggestions.json +0 -1090
- package/dist/nodes/Algolia/specs/recommend.json +0 -3212
- package/dist/nodes/Algolia/specs/search.json +0 -8489
- /package/dist/{nodes/Algolia/algolia.svg → algolia.svg} +0 -0
|
@@ -1,1589 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"openapi": "3.0.2",
|
|
3
|
-
"info": {
|
|
4
|
-
"title": "A/B Testing API",
|
|
5
|
-
"description": "The Algolia A/B Testing API lets you manage your Algolia A/B tests to optimize your search experience.\n\n## Base URLs\n\nThe base URLs for requests to the A/B testing API are:\n\n- `https://analytics.us.algolia.com`\n- `https://analytics.de.algolia.com`\n- `https://analytics.algolia.com` (routes requests to the closest of the above servers, based on your geographical location)\n\nUse the URL that matches your [analytics region](https://dashboard.algolia.com/account/infrastructure/analytics).\n\n**All requests must use HTTPS.**\n\n## Availability and authentication\n\nAccess to the A/B testing API is available as part of the [Premium or Elevate plans](https://www.algolia.com/pricing).\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## Rate limits\n\nYou can make up to **100 requests per minute per app** to the A/B testing API.\nThe response includes headers with information about the limits.\n\n## Parameters\n\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 A/B testing 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 A/B Testing API is version 3, as indicated by the `/3/` in each endpoint's URL.\n",
|
|
6
|
-
"version": "3.0.0"
|
|
7
|
-
},
|
|
8
|
-
"servers": [
|
|
9
|
-
{
|
|
10
|
-
"url": "https://analytics.{region}.algolia.com",
|
|
11
|
-
"variables": {
|
|
12
|
-
"region": {
|
|
13
|
-
"enum": ["us", "de"],
|
|
14
|
-
"default": "us"
|
|
15
|
-
}
|
|
16
|
-
}
|
|
17
|
-
},
|
|
18
|
-
{
|
|
19
|
-
"url": "https://analytics.algolia.com"
|
|
20
|
-
}
|
|
21
|
-
],
|
|
22
|
-
"security": [
|
|
23
|
-
{
|
|
24
|
-
"applicationId": [],
|
|
25
|
-
"apiKey": []
|
|
26
|
-
}
|
|
27
|
-
],
|
|
28
|
-
"tags": [
|
|
29
|
-
{
|
|
30
|
-
"name": "abtest",
|
|
31
|
-
"x-displayName": "A/B testing",
|
|
32
|
-
"description": "Manage A/B tests.\n\nA/B tests are configurations one or more indices, usually your production index and an index with different settings that you want to test.\n"
|
|
33
|
-
}
|
|
34
|
-
],
|
|
35
|
-
"externalDocs": {
|
|
36
|
-
"url": "https://www.algolia.com/doc/guides/ab-testing/what-is-ab-testing",
|
|
37
|
-
"description": "A/B testing."
|
|
38
|
-
},
|
|
39
|
-
"paths": {
|
|
40
|
-
"/{path}": {
|
|
41
|
-
"get": {
|
|
42
|
-
"operationId": "customGet",
|
|
43
|
-
"summary": "Send requests to the Algolia REST API",
|
|
44
|
-
"description": "This method lets you send requests to the Algolia REST API.",
|
|
45
|
-
"parameters": [
|
|
46
|
-
{
|
|
47
|
-
"$ref": "#/components/parameters/PathInPath"
|
|
48
|
-
},
|
|
49
|
-
{
|
|
50
|
-
"$ref": "#/components/parameters/Parameters"
|
|
51
|
-
}
|
|
52
|
-
],
|
|
53
|
-
"responses": {
|
|
54
|
-
"200": {
|
|
55
|
-
"description": "OK",
|
|
56
|
-
"content": {
|
|
57
|
-
"application/json": {
|
|
58
|
-
"schema": {
|
|
59
|
-
"type": "object"
|
|
60
|
-
}
|
|
61
|
-
}
|
|
62
|
-
}
|
|
63
|
-
},
|
|
64
|
-
"400": {
|
|
65
|
-
"$ref": "#/components/responses/BadRequest"
|
|
66
|
-
},
|
|
67
|
-
"402": {
|
|
68
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
69
|
-
},
|
|
70
|
-
"403": {
|
|
71
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
72
|
-
},
|
|
73
|
-
"404": {
|
|
74
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
75
|
-
}
|
|
76
|
-
}
|
|
77
|
-
},
|
|
78
|
-
"post": {
|
|
79
|
-
"operationId": "customPost",
|
|
80
|
-
"requestBody": {
|
|
81
|
-
"description": "Parameters to send with the custom request.",
|
|
82
|
-
"content": {
|
|
83
|
-
"application/json": {
|
|
84
|
-
"schema": {
|
|
85
|
-
"type": "object"
|
|
86
|
-
}
|
|
87
|
-
}
|
|
88
|
-
}
|
|
89
|
-
},
|
|
90
|
-
"summary": "Send requests to the Algolia REST API",
|
|
91
|
-
"description": "This method lets you send requests to the Algolia REST API.",
|
|
92
|
-
"parameters": [
|
|
93
|
-
{
|
|
94
|
-
"$ref": "#/components/parameters/PathInPath"
|
|
95
|
-
},
|
|
96
|
-
{
|
|
97
|
-
"$ref": "#/components/parameters/Parameters"
|
|
98
|
-
}
|
|
99
|
-
],
|
|
100
|
-
"responses": {
|
|
101
|
-
"200": {
|
|
102
|
-
"description": "OK",
|
|
103
|
-
"content": {
|
|
104
|
-
"application/json": {
|
|
105
|
-
"schema": {
|
|
106
|
-
"type": "object"
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
},
|
|
111
|
-
"400": {
|
|
112
|
-
"$ref": "#/components/responses/BadRequest"
|
|
113
|
-
},
|
|
114
|
-
"402": {
|
|
115
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
116
|
-
},
|
|
117
|
-
"403": {
|
|
118
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
119
|
-
},
|
|
120
|
-
"404": {
|
|
121
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
122
|
-
}
|
|
123
|
-
}
|
|
124
|
-
},
|
|
125
|
-
"put": {
|
|
126
|
-
"operationId": "customPut",
|
|
127
|
-
"requestBody": {
|
|
128
|
-
"description": "Parameters to send with the custom request.",
|
|
129
|
-
"content": {
|
|
130
|
-
"application/json": {
|
|
131
|
-
"schema": {
|
|
132
|
-
"type": "object"
|
|
133
|
-
}
|
|
134
|
-
}
|
|
135
|
-
}
|
|
136
|
-
},
|
|
137
|
-
"summary": "Send requests to the Algolia REST API",
|
|
138
|
-
"description": "This method lets you send requests to the Algolia REST API.",
|
|
139
|
-
"parameters": [
|
|
140
|
-
{
|
|
141
|
-
"$ref": "#/components/parameters/PathInPath"
|
|
142
|
-
},
|
|
143
|
-
{
|
|
144
|
-
"$ref": "#/components/parameters/Parameters"
|
|
145
|
-
}
|
|
146
|
-
],
|
|
147
|
-
"responses": {
|
|
148
|
-
"200": {
|
|
149
|
-
"description": "OK",
|
|
150
|
-
"content": {
|
|
151
|
-
"application/json": {
|
|
152
|
-
"schema": {
|
|
153
|
-
"type": "object"
|
|
154
|
-
}
|
|
155
|
-
}
|
|
156
|
-
}
|
|
157
|
-
},
|
|
158
|
-
"400": {
|
|
159
|
-
"$ref": "#/components/responses/BadRequest"
|
|
160
|
-
},
|
|
161
|
-
"402": {
|
|
162
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
163
|
-
},
|
|
164
|
-
"403": {
|
|
165
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
166
|
-
},
|
|
167
|
-
"404": {
|
|
168
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
169
|
-
}
|
|
170
|
-
}
|
|
171
|
-
},
|
|
172
|
-
"delete": {
|
|
173
|
-
"operationId": "customDelete",
|
|
174
|
-
"summary": "Send requests to the Algolia REST API",
|
|
175
|
-
"description": "This method lets you send requests to the Algolia REST API.",
|
|
176
|
-
"parameters": [
|
|
177
|
-
{
|
|
178
|
-
"$ref": "#/components/parameters/PathInPath"
|
|
179
|
-
},
|
|
180
|
-
{
|
|
181
|
-
"$ref": "#/components/parameters/Parameters"
|
|
182
|
-
}
|
|
183
|
-
],
|
|
184
|
-
"responses": {
|
|
185
|
-
"200": {
|
|
186
|
-
"description": "OK",
|
|
187
|
-
"content": {
|
|
188
|
-
"application/json": {
|
|
189
|
-
"schema": {
|
|
190
|
-
"type": "object"
|
|
191
|
-
}
|
|
192
|
-
}
|
|
193
|
-
}
|
|
194
|
-
},
|
|
195
|
-
"400": {
|
|
196
|
-
"$ref": "#/components/responses/BadRequest"
|
|
197
|
-
},
|
|
198
|
-
"402": {
|
|
199
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
200
|
-
},
|
|
201
|
-
"403": {
|
|
202
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
203
|
-
},
|
|
204
|
-
"404": {
|
|
205
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
206
|
-
}
|
|
207
|
-
}
|
|
208
|
-
}
|
|
209
|
-
},
|
|
210
|
-
"/3/abtests": {
|
|
211
|
-
"post": {
|
|
212
|
-
"tags": ["abtest"],
|
|
213
|
-
"operationId": "addABTests",
|
|
214
|
-
"x-acl": ["editSettings"],
|
|
215
|
-
"summary": "Create an A/B test",
|
|
216
|
-
"description": "Creates a new A/B test.",
|
|
217
|
-
"requestBody": {
|
|
218
|
-
"required": true,
|
|
219
|
-
"content": {
|
|
220
|
-
"application/json": {
|
|
221
|
-
"schema": {
|
|
222
|
-
"title": "addABTestsRequest",
|
|
223
|
-
"type": "object",
|
|
224
|
-
"additionalProperties": false,
|
|
225
|
-
"properties": {
|
|
226
|
-
"name": {
|
|
227
|
-
"$ref": "#/components/schemas/name"
|
|
228
|
-
},
|
|
229
|
-
"variants": {
|
|
230
|
-
"type": "array",
|
|
231
|
-
"description": "A/B test variants.",
|
|
232
|
-
"minItems": 2,
|
|
233
|
-
"items": {
|
|
234
|
-
"$ref": "#/components/schemas/AddABTestsVariant"
|
|
235
|
-
}
|
|
236
|
-
},
|
|
237
|
-
"metrics": {
|
|
238
|
-
"type": "array",
|
|
239
|
-
"description": "A/B test metrics involved in the test. Only these metrics will be considered when calculating results.",
|
|
240
|
-
"items": {
|
|
241
|
-
"$ref": "#/components/schemas/createMetric"
|
|
242
|
-
}
|
|
243
|
-
},
|
|
244
|
-
"configuration": {
|
|
245
|
-
"$ref": "#/components/schemas/ABTestConfiguration"
|
|
246
|
-
},
|
|
247
|
-
"endAt": {
|
|
248
|
-
"$ref": "#/components/schemas/endAt"
|
|
249
|
-
}
|
|
250
|
-
},
|
|
251
|
-
"required": ["name", "variants", "metrics", "endAt"]
|
|
252
|
-
}
|
|
253
|
-
}
|
|
254
|
-
}
|
|
255
|
-
},
|
|
256
|
-
"responses": {
|
|
257
|
-
"200": {
|
|
258
|
-
"description": "OK",
|
|
259
|
-
"headers": {
|
|
260
|
-
"x-ratelimit-limit": {
|
|
261
|
-
"$ref": "#/components/headers/x-ratelimit-limit"
|
|
262
|
-
},
|
|
263
|
-
"x-ratelimit-remaining": {
|
|
264
|
-
"$ref": "#/components/headers/x-ratelimit-remaining"
|
|
265
|
-
},
|
|
266
|
-
"x-ratelimit-reset": {
|
|
267
|
-
"$ref": "#/components/headers/x-ratelimit-reset"
|
|
268
|
-
}
|
|
269
|
-
},
|
|
270
|
-
"content": {
|
|
271
|
-
"application/json": {
|
|
272
|
-
"schema": {
|
|
273
|
-
"$ref": "#/components/schemas/ABTestResponse"
|
|
274
|
-
}
|
|
275
|
-
}
|
|
276
|
-
}
|
|
277
|
-
},
|
|
278
|
-
"400": {
|
|
279
|
-
"$ref": "#/components/responses/BadRequest"
|
|
280
|
-
},
|
|
281
|
-
"402": {
|
|
282
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
283
|
-
},
|
|
284
|
-
"403": {
|
|
285
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
286
|
-
},
|
|
287
|
-
"404": {
|
|
288
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
289
|
-
}
|
|
290
|
-
}
|
|
291
|
-
},
|
|
292
|
-
"get": {
|
|
293
|
-
"tags": ["abtest"],
|
|
294
|
-
"operationId": "listABTests",
|
|
295
|
-
"x-acl": ["analytics"],
|
|
296
|
-
"summary": "List all A/B tests",
|
|
297
|
-
"description": "Lists all A/B tests you configured for this application.",
|
|
298
|
-
"parameters": [
|
|
299
|
-
{
|
|
300
|
-
"name": "offset",
|
|
301
|
-
"in": "query",
|
|
302
|
-
"description": "Position of the first item to return.",
|
|
303
|
-
"required": false,
|
|
304
|
-
"schema": {
|
|
305
|
-
"type": "integer",
|
|
306
|
-
"default": 0,
|
|
307
|
-
"minimum": 0
|
|
308
|
-
}
|
|
309
|
-
},
|
|
310
|
-
{
|
|
311
|
-
"name": "limit",
|
|
312
|
-
"in": "query",
|
|
313
|
-
"description": "Number of items to return.",
|
|
314
|
-
"required": false,
|
|
315
|
-
"schema": {
|
|
316
|
-
"type": "integer",
|
|
317
|
-
"default": 10
|
|
318
|
-
}
|
|
319
|
-
},
|
|
320
|
-
{
|
|
321
|
-
"name": "indexPrefix",
|
|
322
|
-
"in": "query",
|
|
323
|
-
"description": "Index name prefix. Only A/B tests for indices starting with this string are included in the response.",
|
|
324
|
-
"example": "dev_",
|
|
325
|
-
"schema": {
|
|
326
|
-
"type": "string"
|
|
327
|
-
}
|
|
328
|
-
},
|
|
329
|
-
{
|
|
330
|
-
"name": "indexSuffix",
|
|
331
|
-
"in": "query",
|
|
332
|
-
"description": "Index name suffix. Only A/B tests for indices ending with this string are included in the response.",
|
|
333
|
-
"example": "_development",
|
|
334
|
-
"schema": {
|
|
335
|
-
"type": "string"
|
|
336
|
-
}
|
|
337
|
-
},
|
|
338
|
-
{
|
|
339
|
-
"name": "direction",
|
|
340
|
-
"in": "query",
|
|
341
|
-
"description": "Sort order for A/B tests by start date.\nUse 'asc' for ascending or 'desc' for descending. Active A/B tests are always listed first.\n",
|
|
342
|
-
"example": "desc",
|
|
343
|
-
"schema": {
|
|
344
|
-
"$ref": "#/components/schemas/direction"
|
|
345
|
-
}
|
|
346
|
-
}
|
|
347
|
-
],
|
|
348
|
-
"responses": {
|
|
349
|
-
"200": {
|
|
350
|
-
"description": "OK",
|
|
351
|
-
"headers": {
|
|
352
|
-
"x-ratelimit-limit": {
|
|
353
|
-
"$ref": "#/components/headers/x-ratelimit-limit"
|
|
354
|
-
},
|
|
355
|
-
"x-ratelimit-remaining": {
|
|
356
|
-
"$ref": "#/components/headers/x-ratelimit-remaining"
|
|
357
|
-
},
|
|
358
|
-
"x-ratelimit-reset": {
|
|
359
|
-
"$ref": "#/components/headers/x-ratelimit-reset"
|
|
360
|
-
}
|
|
361
|
-
},
|
|
362
|
-
"content": {
|
|
363
|
-
"application/json": {
|
|
364
|
-
"schema": {
|
|
365
|
-
"title": "listABTestsResponse",
|
|
366
|
-
"type": "object",
|
|
367
|
-
"additionalProperties": false,
|
|
368
|
-
"properties": {
|
|
369
|
-
"abtests": {
|
|
370
|
-
"$ref": "#/components/schemas/ABTests"
|
|
371
|
-
},
|
|
372
|
-
"count": {
|
|
373
|
-
"type": "integer",
|
|
374
|
-
"description": "Number of A/B tests.",
|
|
375
|
-
"example": 10
|
|
376
|
-
},
|
|
377
|
-
"total": {
|
|
378
|
-
"type": "integer",
|
|
379
|
-
"description": "Number of retrievable A/B tests.",
|
|
380
|
-
"example": 12
|
|
381
|
-
}
|
|
382
|
-
},
|
|
383
|
-
"required": ["abtests", "count", "total"]
|
|
384
|
-
}
|
|
385
|
-
}
|
|
386
|
-
}
|
|
387
|
-
},
|
|
388
|
-
"400": {
|
|
389
|
-
"$ref": "#/components/responses/BadRequest"
|
|
390
|
-
},
|
|
391
|
-
"402": {
|
|
392
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
393
|
-
},
|
|
394
|
-
"403": {
|
|
395
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
396
|
-
},
|
|
397
|
-
"404": {
|
|
398
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
399
|
-
}
|
|
400
|
-
}
|
|
401
|
-
}
|
|
402
|
-
},
|
|
403
|
-
"/3/abtests/{id}": {
|
|
404
|
-
"get": {
|
|
405
|
-
"tags": ["abtest"],
|
|
406
|
-
"operationId": "getABTest",
|
|
407
|
-
"x-acl": ["analytics"],
|
|
408
|
-
"summary": "Retrieve A/B test details",
|
|
409
|
-
"description": "Retrieves the details for an A/B test by its ID.",
|
|
410
|
-
"parameters": [
|
|
411
|
-
{
|
|
412
|
-
"$ref": "#/components/parameters/ID"
|
|
413
|
-
}
|
|
414
|
-
],
|
|
415
|
-
"responses": {
|
|
416
|
-
"200": {
|
|
417
|
-
"description": "OK",
|
|
418
|
-
"headers": {
|
|
419
|
-
"x-ratelimit-limit": {
|
|
420
|
-
"$ref": "#/components/headers/x-ratelimit-limit"
|
|
421
|
-
},
|
|
422
|
-
"x-ratelimit-remaining": {
|
|
423
|
-
"$ref": "#/components/headers/x-ratelimit-remaining"
|
|
424
|
-
},
|
|
425
|
-
"x-ratelimit-reset": {
|
|
426
|
-
"$ref": "#/components/headers/x-ratelimit-reset"
|
|
427
|
-
}
|
|
428
|
-
},
|
|
429
|
-
"content": {
|
|
430
|
-
"application/json": {
|
|
431
|
-
"schema": {
|
|
432
|
-
"$ref": "#/components/schemas/ABTest"
|
|
433
|
-
}
|
|
434
|
-
}
|
|
435
|
-
}
|
|
436
|
-
},
|
|
437
|
-
"400": {
|
|
438
|
-
"$ref": "#/components/responses/BadRequest"
|
|
439
|
-
},
|
|
440
|
-
"402": {
|
|
441
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
442
|
-
},
|
|
443
|
-
"403": {
|
|
444
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
445
|
-
},
|
|
446
|
-
"404": {
|
|
447
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
448
|
-
}
|
|
449
|
-
}
|
|
450
|
-
},
|
|
451
|
-
"delete": {
|
|
452
|
-
"tags": ["abtest"],
|
|
453
|
-
"operationId": "deleteABTest",
|
|
454
|
-
"x-acl": ["editSettings"],
|
|
455
|
-
"summary": "Delete an A/B test",
|
|
456
|
-
"description": "Deletes an A/B test by its ID.",
|
|
457
|
-
"parameters": [
|
|
458
|
-
{
|
|
459
|
-
"$ref": "#/components/parameters/ID"
|
|
460
|
-
}
|
|
461
|
-
],
|
|
462
|
-
"responses": {
|
|
463
|
-
"200": {
|
|
464
|
-
"description": "OK",
|
|
465
|
-
"headers": {
|
|
466
|
-
"x-ratelimit-limit": {
|
|
467
|
-
"$ref": "#/components/headers/x-ratelimit-limit"
|
|
468
|
-
},
|
|
469
|
-
"x-ratelimit-remaining": {
|
|
470
|
-
"$ref": "#/components/headers/x-ratelimit-remaining"
|
|
471
|
-
},
|
|
472
|
-
"x-ratelimit-reset": {
|
|
473
|
-
"$ref": "#/components/headers/x-ratelimit-reset"
|
|
474
|
-
}
|
|
475
|
-
},
|
|
476
|
-
"content": {
|
|
477
|
-
"application/json": {
|
|
478
|
-
"schema": {
|
|
479
|
-
"$ref": "#/components/schemas/ABTestResponse"
|
|
480
|
-
}
|
|
481
|
-
}
|
|
482
|
-
}
|
|
483
|
-
},
|
|
484
|
-
"400": {
|
|
485
|
-
"$ref": "#/components/responses/BadRequest"
|
|
486
|
-
},
|
|
487
|
-
"402": {
|
|
488
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
489
|
-
},
|
|
490
|
-
"403": {
|
|
491
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
492
|
-
},
|
|
493
|
-
"404": {
|
|
494
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
495
|
-
}
|
|
496
|
-
}
|
|
497
|
-
}
|
|
498
|
-
},
|
|
499
|
-
"/3/abtests/{id}/stop": {
|
|
500
|
-
"post": {
|
|
501
|
-
"tags": ["abtest"],
|
|
502
|
-
"operationId": "stopABTest",
|
|
503
|
-
"x-acl": ["editSettings"],
|
|
504
|
-
"summary": "Stop an A/B test",
|
|
505
|
-
"description": "Stops an A/B test by its ID.\n\nYou can't restart stopped A/B tests.\n",
|
|
506
|
-
"parameters": [
|
|
507
|
-
{
|
|
508
|
-
"$ref": "#/components/parameters/ID"
|
|
509
|
-
}
|
|
510
|
-
],
|
|
511
|
-
"responses": {
|
|
512
|
-
"200": {
|
|
513
|
-
"description": "OK",
|
|
514
|
-
"headers": {
|
|
515
|
-
"x-ratelimit-limit": {
|
|
516
|
-
"$ref": "#/components/headers/x-ratelimit-limit"
|
|
517
|
-
},
|
|
518
|
-
"x-ratelimit-remaining": {
|
|
519
|
-
"$ref": "#/components/headers/x-ratelimit-remaining"
|
|
520
|
-
},
|
|
521
|
-
"x-ratelimit-reset": {
|
|
522
|
-
"$ref": "#/components/headers/x-ratelimit-reset"
|
|
523
|
-
}
|
|
524
|
-
},
|
|
525
|
-
"content": {
|
|
526
|
-
"application/json": {
|
|
527
|
-
"schema": {
|
|
528
|
-
"$ref": "#/components/schemas/ABTestResponse"
|
|
529
|
-
}
|
|
530
|
-
}
|
|
531
|
-
}
|
|
532
|
-
},
|
|
533
|
-
"400": {
|
|
534
|
-
"$ref": "#/components/responses/BadRequest"
|
|
535
|
-
},
|
|
536
|
-
"402": {
|
|
537
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
538
|
-
},
|
|
539
|
-
"403": {
|
|
540
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
541
|
-
},
|
|
542
|
-
"404": {
|
|
543
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
544
|
-
}
|
|
545
|
-
}
|
|
546
|
-
}
|
|
547
|
-
},
|
|
548
|
-
"/3/abtests/schedule": {
|
|
549
|
-
"post": {
|
|
550
|
-
"tags": ["abtest"],
|
|
551
|
-
"operationId": "scheduleABTest",
|
|
552
|
-
"x-acl": ["editSettings"],
|
|
553
|
-
"summary": "Schedule an A/B test",
|
|
554
|
-
"description": "Schedule an A/B test to be started at a later time.\n",
|
|
555
|
-
"requestBody": {
|
|
556
|
-
"required": true,
|
|
557
|
-
"content": {
|
|
558
|
-
"application/json": {
|
|
559
|
-
"schema": {
|
|
560
|
-
"title": "scheduleABTestsRequest",
|
|
561
|
-
"type": "object",
|
|
562
|
-
"additionalProperties": false,
|
|
563
|
-
"properties": {
|
|
564
|
-
"name": {
|
|
565
|
-
"$ref": "#/components/schemas/name"
|
|
566
|
-
},
|
|
567
|
-
"variants": {
|
|
568
|
-
"type": "array",
|
|
569
|
-
"description": "A/B test variants.",
|
|
570
|
-
"minItems": 2,
|
|
571
|
-
"items": {
|
|
572
|
-
"$ref": "#/components/schemas/AddABTestsVariant"
|
|
573
|
-
}
|
|
574
|
-
},
|
|
575
|
-
"metrics": {
|
|
576
|
-
"type": "array",
|
|
577
|
-
"description": "A/B test metrics involved in the test. Only these metrics will be considered when calculating results.",
|
|
578
|
-
"items": {
|
|
579
|
-
"$ref": "#/components/schemas/createMetric"
|
|
580
|
-
}
|
|
581
|
-
},
|
|
582
|
-
"configuration": {
|
|
583
|
-
"$ref": "#/components/schemas/ABTestConfiguration"
|
|
584
|
-
},
|
|
585
|
-
"scheduledAt": {
|
|
586
|
-
"$ref": "#/components/schemas/scheduledAt"
|
|
587
|
-
},
|
|
588
|
-
"endAt": {
|
|
589
|
-
"$ref": "#/components/schemas/endAt"
|
|
590
|
-
}
|
|
591
|
-
},
|
|
592
|
-
"required": ["name", "variants", "metrics", "scheduledAt", "endAt"]
|
|
593
|
-
}
|
|
594
|
-
}
|
|
595
|
-
}
|
|
596
|
-
},
|
|
597
|
-
"responses": {
|
|
598
|
-
"200": {
|
|
599
|
-
"description": "OK",
|
|
600
|
-
"headers": {
|
|
601
|
-
"x-ratelimit-limit": {
|
|
602
|
-
"$ref": "#/components/headers/x-ratelimit-limit"
|
|
603
|
-
},
|
|
604
|
-
"x-ratelimit-remaining": {
|
|
605
|
-
"$ref": "#/components/headers/x-ratelimit-remaining"
|
|
606
|
-
},
|
|
607
|
-
"x-ratelimit-reset": {
|
|
608
|
-
"$ref": "#/components/headers/x-ratelimit-reset"
|
|
609
|
-
}
|
|
610
|
-
},
|
|
611
|
-
"content": {
|
|
612
|
-
"application/json": {
|
|
613
|
-
"schema": {
|
|
614
|
-
"$ref": "#/components/schemas/ScheduleABTestResponse"
|
|
615
|
-
}
|
|
616
|
-
}
|
|
617
|
-
}
|
|
618
|
-
},
|
|
619
|
-
"400": {
|
|
620
|
-
"$ref": "#/components/responses/BadRequest"
|
|
621
|
-
},
|
|
622
|
-
"402": {
|
|
623
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
624
|
-
},
|
|
625
|
-
"403": {
|
|
626
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
627
|
-
},
|
|
628
|
-
"404": {
|
|
629
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
630
|
-
}
|
|
631
|
-
}
|
|
632
|
-
}
|
|
633
|
-
},
|
|
634
|
-
"/3/abtests/estimate": {
|
|
635
|
-
"post": {
|
|
636
|
-
"tags": ["abtest"],
|
|
637
|
-
"operationId": "estimateABTest",
|
|
638
|
-
"x-acl": ["analytics"],
|
|
639
|
-
"summary": "Estimate the sample size and duration of an A/B test",
|
|
640
|
-
"description": "Given the traffic percentage and the expected effect size, this endpoint estimates the sample size and duration of an A/B test based on historical traffic.",
|
|
641
|
-
"requestBody": {
|
|
642
|
-
"required": true,
|
|
643
|
-
"content": {
|
|
644
|
-
"application/json": {
|
|
645
|
-
"schema": {
|
|
646
|
-
"title": "estimateABTestRequest",
|
|
647
|
-
"type": "object",
|
|
648
|
-
"additionalProperties": false,
|
|
649
|
-
"properties": {
|
|
650
|
-
"configuration": {
|
|
651
|
-
"title": "estimateConfiguration",
|
|
652
|
-
"type": "object",
|
|
653
|
-
"description": "A/B test configuration for estimating the sample size and duration using minimum detectable effect.",
|
|
654
|
-
"properties": {
|
|
655
|
-
"filters": {
|
|
656
|
-
"$ref": "#/components/schemas/MetricsFilters"
|
|
657
|
-
},
|
|
658
|
-
"minimumDetectableEffect": {
|
|
659
|
-
"$ref": "#/components/schemas/MinimumDetectableEffect"
|
|
660
|
-
}
|
|
661
|
-
},
|
|
662
|
-
"required": ["minimumDetectableEffect"]
|
|
663
|
-
},
|
|
664
|
-
"variants": {
|
|
665
|
-
"type": "array",
|
|
666
|
-
"description": "A/B test variants.",
|
|
667
|
-
"minItems": 2,
|
|
668
|
-
"items": {
|
|
669
|
-
"$ref": "#/components/schemas/AddABTestsVariant"
|
|
670
|
-
}
|
|
671
|
-
}
|
|
672
|
-
},
|
|
673
|
-
"required": ["configuration", "variants"]
|
|
674
|
-
}
|
|
675
|
-
}
|
|
676
|
-
}
|
|
677
|
-
},
|
|
678
|
-
"responses": {
|
|
679
|
-
"200": {
|
|
680
|
-
"description": "OK",
|
|
681
|
-
"headers": {
|
|
682
|
-
"x-ratelimit-limit": {
|
|
683
|
-
"$ref": "#/components/headers/x-ratelimit-limit"
|
|
684
|
-
},
|
|
685
|
-
"x-ratelimit-remaining": {
|
|
686
|
-
"$ref": "#/components/headers/x-ratelimit-remaining"
|
|
687
|
-
},
|
|
688
|
-
"x-ratelimit-reset": {
|
|
689
|
-
"$ref": "#/components/headers/x-ratelimit-reset"
|
|
690
|
-
}
|
|
691
|
-
},
|
|
692
|
-
"content": {
|
|
693
|
-
"application/json": {
|
|
694
|
-
"schema": {
|
|
695
|
-
"$ref": "#/components/schemas/EstimateABTestResponse"
|
|
696
|
-
}
|
|
697
|
-
}
|
|
698
|
-
}
|
|
699
|
-
},
|
|
700
|
-
"400": {
|
|
701
|
-
"$ref": "#/components/responses/BadRequest"
|
|
702
|
-
},
|
|
703
|
-
"402": {
|
|
704
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
705
|
-
},
|
|
706
|
-
"403": {
|
|
707
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
708
|
-
},
|
|
709
|
-
"404": {
|
|
710
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
711
|
-
}
|
|
712
|
-
}
|
|
713
|
-
}
|
|
714
|
-
},
|
|
715
|
-
"/3/abtests/{id}/timeseries": {
|
|
716
|
-
"get": {
|
|
717
|
-
"tags": ["abtest"],
|
|
718
|
-
"operationId": "getTimeseries",
|
|
719
|
-
"x-acl": ["analytics"],
|
|
720
|
-
"summary": "Retrieve timeseries of an A/B test",
|
|
721
|
-
"description": "Retrieves timeseries for an A/B test by its ID.",
|
|
722
|
-
"parameters": [
|
|
723
|
-
{
|
|
724
|
-
"$ref": "#/components/parameters/ID"
|
|
725
|
-
},
|
|
726
|
-
{
|
|
727
|
-
"$ref": "#/components/parameters/StartDate"
|
|
728
|
-
},
|
|
729
|
-
{
|
|
730
|
-
"$ref": "#/components/parameters/EndDate"
|
|
731
|
-
},
|
|
732
|
-
{
|
|
733
|
-
"in": "query",
|
|
734
|
-
"name": "metric",
|
|
735
|
-
"description": "List of metrics to retrieve. If not specified, all metrics are returned.",
|
|
736
|
-
"schema": {
|
|
737
|
-
"type": "array",
|
|
738
|
-
"items": {
|
|
739
|
-
"$ref": "#/components/schemas/MetricName"
|
|
740
|
-
}
|
|
741
|
-
}
|
|
742
|
-
}
|
|
743
|
-
],
|
|
744
|
-
"responses": {
|
|
745
|
-
"200": {
|
|
746
|
-
"description": "OK",
|
|
747
|
-
"headers": {
|
|
748
|
-
"x-ratelimit-limit": {
|
|
749
|
-
"$ref": "#/components/headers/x-ratelimit-limit"
|
|
750
|
-
},
|
|
751
|
-
"x-ratelimit-remaining": {
|
|
752
|
-
"$ref": "#/components/headers/x-ratelimit-remaining"
|
|
753
|
-
},
|
|
754
|
-
"x-ratelimit-reset": {
|
|
755
|
-
"$ref": "#/components/headers/x-ratelimit-reset"
|
|
756
|
-
}
|
|
757
|
-
},
|
|
758
|
-
"content": {
|
|
759
|
-
"application/json": {
|
|
760
|
-
"schema": {
|
|
761
|
-
"$ref": "#/components/schemas/Timeseries"
|
|
762
|
-
}
|
|
763
|
-
}
|
|
764
|
-
}
|
|
765
|
-
},
|
|
766
|
-
"400": {
|
|
767
|
-
"$ref": "#/components/responses/BadRequest"
|
|
768
|
-
},
|
|
769
|
-
"402": {
|
|
770
|
-
"$ref": "#/components/responses/FeatureNotEnabled"
|
|
771
|
-
},
|
|
772
|
-
"403": {
|
|
773
|
-
"$ref": "#/components/responses/MethodNotAllowed"
|
|
774
|
-
},
|
|
775
|
-
"404": {
|
|
776
|
-
"$ref": "#/components/responses/IndexNotFound"
|
|
777
|
-
},
|
|
778
|
-
"422": {
|
|
779
|
-
"$ref": "#/components/responses/UnprocessableEntity"
|
|
780
|
-
}
|
|
781
|
-
}
|
|
782
|
-
}
|
|
783
|
-
},
|
|
784
|
-
"/setClientApiKey": {
|
|
785
|
-
"get": {
|
|
786
|
-
"x-helper": true,
|
|
787
|
-
"x-asynchronous-helper": false,
|
|
788
|
-
"tags": ["Api Key"],
|
|
789
|
-
"operationId": "setClientApiKey",
|
|
790
|
-
"summary": "Switch the API key used to authenticate requests",
|
|
791
|
-
"description": "Switch the API key used to authenticate requests.\n",
|
|
792
|
-
"parameters": [
|
|
793
|
-
{
|
|
794
|
-
"in": "query",
|
|
795
|
-
"name": "apiKey",
|
|
796
|
-
"description": "API key to be used from now on.",
|
|
797
|
-
"required": true,
|
|
798
|
-
"schema": {
|
|
799
|
-
"type": "string"
|
|
800
|
-
}
|
|
801
|
-
}
|
|
802
|
-
],
|
|
803
|
-
"responses": {
|
|
804
|
-
"204": {
|
|
805
|
-
"description": "No content."
|
|
806
|
-
}
|
|
807
|
-
}
|
|
808
|
-
}
|
|
809
|
-
}
|
|
810
|
-
},
|
|
811
|
-
"components": {
|
|
812
|
-
"securitySchemes": {
|
|
813
|
-
"applicationId": {
|
|
814
|
-
"type": "apiKey",
|
|
815
|
-
"in": "header",
|
|
816
|
-
"name": "x-algolia-application-id",
|
|
817
|
-
"description": "Your Algolia application ID."
|
|
818
|
-
},
|
|
819
|
-
"apiKey": {
|
|
820
|
-
"type": "apiKey",
|
|
821
|
-
"in": "header",
|
|
822
|
-
"name": "x-algolia-api-key",
|
|
823
|
-
"description": "Your Algolia API key with the necessary permissions to make the request.\nPermissions are controlled through access control lists (ACL) and access restrictions.\nThe required ACL to make a request is listed in each endpoint's reference.\n"
|
|
824
|
-
}
|
|
825
|
-
},
|
|
826
|
-
"parameters": {
|
|
827
|
-
"PathInPath": {
|
|
828
|
-
"name": "path",
|
|
829
|
-
"in": "path",
|
|
830
|
-
"description": "Path of the endpoint, for example `1/newFeature`.",
|
|
831
|
-
"required": true,
|
|
832
|
-
"schema": {
|
|
833
|
-
"type": "string",
|
|
834
|
-
"example": "/keys"
|
|
835
|
-
}
|
|
836
|
-
},
|
|
837
|
-
"Parameters": {
|
|
838
|
-
"name": "parameters",
|
|
839
|
-
"in": "query",
|
|
840
|
-
"description": "Query parameters to apply to the current query.",
|
|
841
|
-
"schema": {
|
|
842
|
-
"type": "object",
|
|
843
|
-
"additionalProperties": true
|
|
844
|
-
}
|
|
845
|
-
},
|
|
846
|
-
"ID": {
|
|
847
|
-
"in": "path",
|
|
848
|
-
"name": "id",
|
|
849
|
-
"description": "Unique A/B test identifier.",
|
|
850
|
-
"required": true,
|
|
851
|
-
"schema": {
|
|
852
|
-
"$ref": "#/components/schemas/abTestID"
|
|
853
|
-
}
|
|
854
|
-
},
|
|
855
|
-
"StartDate": {
|
|
856
|
-
"in": "query",
|
|
857
|
-
"name": "startDate",
|
|
858
|
-
"description": "Start date of the period to analyze, in `YYYY-MM-DD` format.",
|
|
859
|
-
"schema": {
|
|
860
|
-
"type": "string",
|
|
861
|
-
"example": "2022-09-19"
|
|
862
|
-
}
|
|
863
|
-
},
|
|
864
|
-
"EndDate": {
|
|
865
|
-
"in": "query",
|
|
866
|
-
"name": "endDate",
|
|
867
|
-
"description": "End date of the period to analyze, in `YYYY-MM-DD` format.",
|
|
868
|
-
"schema": {
|
|
869
|
-
"type": "string",
|
|
870
|
-
"example": "2023-01-21"
|
|
871
|
-
}
|
|
872
|
-
}
|
|
873
|
-
},
|
|
874
|
-
"schemas": {
|
|
875
|
-
"ErrorBase": {
|
|
876
|
-
"description": "Error.",
|
|
877
|
-
"type": "object",
|
|
878
|
-
"x-keep-model": true,
|
|
879
|
-
"additionalProperties": true,
|
|
880
|
-
"properties": {
|
|
881
|
-
"message": {
|
|
882
|
-
"type": "string",
|
|
883
|
-
"example": "Invalid Application-Id or API-Key"
|
|
884
|
-
}
|
|
885
|
-
}
|
|
886
|
-
},
|
|
887
|
-
"direction": {
|
|
888
|
-
"type": "string",
|
|
889
|
-
"description": "Sort order for A/B tests by start date.\nUse 'asc' for ascending or 'desc' for descending.\nActive A/B tests are always listed first.\n",
|
|
890
|
-
"enum": ["asc", "desc"],
|
|
891
|
-
"example": "desc"
|
|
892
|
-
},
|
|
893
|
-
"abTestID": {
|
|
894
|
-
"type": "integer",
|
|
895
|
-
"description": "Unique A/B test identifier.",
|
|
896
|
-
"example": 224
|
|
897
|
-
},
|
|
898
|
-
"updatedAt": {
|
|
899
|
-
"type": "string",
|
|
900
|
-
"description": "Date and time when the A/B test was last updated, in RFC 3339 format.",
|
|
901
|
-
"example": "2023-06-15T15:06:44.400601Z"
|
|
902
|
-
},
|
|
903
|
-
"createdAt": {
|
|
904
|
-
"type": "string",
|
|
905
|
-
"description": "Date and time when the A/B test was created, in RFC 3339 format.",
|
|
906
|
-
"example": "2023-06-15T15:06:04.249906Z"
|
|
907
|
-
},
|
|
908
|
-
"endAt": {
|
|
909
|
-
"type": "string",
|
|
910
|
-
"description": "End date and time of the A/B test, in RFC 3339 format.",
|
|
911
|
-
"example": "2023-06-17T00:00:00Z"
|
|
912
|
-
},
|
|
913
|
-
"stoppedAt": {
|
|
914
|
-
"type": "string",
|
|
915
|
-
"description": "Date and time when the A/B test was stopped, in RFC 3339 format.",
|
|
916
|
-
"example": "2023-06-15T15:06:44.400601Z",
|
|
917
|
-
"nullable": true
|
|
918
|
-
},
|
|
919
|
-
"name": {
|
|
920
|
-
"type": "string",
|
|
921
|
-
"description": "A/B test name.",
|
|
922
|
-
"example": "Custom ranking sales rank test"
|
|
923
|
-
},
|
|
924
|
-
"Status": {
|
|
925
|
-
"type": "string",
|
|
926
|
-
"description": "A/B test status.\n\n- `active`. The A/B test is live and search traffic is split between the two variants.\n- `stopped`. You stopped the A/B test. The A/B test data is still available for analysis.\n- `expired`. The A/B test was automatically stopped after reaching its end date.\n- `failed`. Creating the A/B test failed.\n",
|
|
927
|
-
"example": "active",
|
|
928
|
-
"enum": ["active", "stopped", "expired", "failed"]
|
|
929
|
-
},
|
|
930
|
-
"description": {
|
|
931
|
-
"type": "string",
|
|
932
|
-
"description": "Description for this variant.",
|
|
933
|
-
"example": "Current production index"
|
|
934
|
-
},
|
|
935
|
-
"index": {
|
|
936
|
-
"type": "string",
|
|
937
|
-
"description": "Index name of the A/B test variant (case-sensitive).",
|
|
938
|
-
"example": "delcourt_production"
|
|
939
|
-
},
|
|
940
|
-
"trafficPercentage": {
|
|
941
|
-
"type": "integer",
|
|
942
|
-
"description": "Percentage of search requests each variant receives.",
|
|
943
|
-
"minimum": 1,
|
|
944
|
-
"maximum": 99,
|
|
945
|
-
"example": 60
|
|
946
|
-
},
|
|
947
|
-
"metricMetadata": {
|
|
948
|
-
"type": "object",
|
|
949
|
-
"description": "Metric specific metadata.",
|
|
950
|
-
"properties": {
|
|
951
|
-
"winsorizedValue": {
|
|
952
|
-
"type": "number",
|
|
953
|
-
"format": "double",
|
|
954
|
-
"description": "Only present in case the metric is 'revenue'.\nIt is the amount exceeding the 95th percentile of global revenue transactions involved in the AB Test. This amount is not considered when calculating statistical significance.\nIt is tied to a per revenue-currency pair contrary to other\nglobal filter effects (such as outliers and empty search count).\n"
|
|
955
|
-
},
|
|
956
|
-
"mean": {
|
|
957
|
-
"type": "number",
|
|
958
|
-
"format": "double",
|
|
959
|
-
"description": "Mean value for this metric.",
|
|
960
|
-
"example": 53.7
|
|
961
|
-
}
|
|
962
|
-
},
|
|
963
|
-
"example": {
|
|
964
|
-
"winsorizedValue": 888.8,
|
|
965
|
-
"mean": 53.7
|
|
966
|
-
}
|
|
967
|
-
},
|
|
968
|
-
"metricResult": {
|
|
969
|
-
"type": "object",
|
|
970
|
-
"properties": {
|
|
971
|
-
"name": {
|
|
972
|
-
"type": "string"
|
|
973
|
-
},
|
|
974
|
-
"updatedAt": {
|
|
975
|
-
"type": "string",
|
|
976
|
-
"description": "Date and time when the metric was last updated, in RFC 3339 format."
|
|
977
|
-
},
|
|
978
|
-
"value": {
|
|
979
|
-
"type": "number",
|
|
980
|
-
"format": "double"
|
|
981
|
-
},
|
|
982
|
-
"valueCIHigh": {
|
|
983
|
-
"type": "number",
|
|
984
|
-
"format": "double",
|
|
985
|
-
"description": "The upper bound of the 95% confidence interval for the metric value. The confidence interval is calculated using\neither the relative ratio or relative difference between the metric values for the control and the variant.\nRelative ratio is used for metrics that are ratios (e.g., click-through rate, conversion rate),\nwhile relative difference is used for continuous metrics (e.g., revenue).\n"
|
|
986
|
-
},
|
|
987
|
-
"valueCILow": {
|
|
988
|
-
"type": "number",
|
|
989
|
-
"format": "double",
|
|
990
|
-
"description": "The lower bound of the 95% confidence interval for the metric value. The confidence interval is calculated using\neither the relative ratio or relative difference between the metric values for the control and the variant.\nRelative ratio is used for metrics that are ratios (e.g., click-through rate, conversion rate),\nwhile relative difference is used for continuous metrics (e.g., revenue).\n"
|
|
991
|
-
},
|
|
992
|
-
"pValue": {
|
|
993
|
-
"type": "number",
|
|
994
|
-
"format": "double",
|
|
995
|
-
"description": "PValue for the first variant (control) will always be 0. For the other variants, pValue is calculated for the current variant based on the control."
|
|
996
|
-
},
|
|
997
|
-
"dimension": {
|
|
998
|
-
"type": "string",
|
|
999
|
-
"description": "Dimension defined during test creation."
|
|
1000
|
-
},
|
|
1001
|
-
"metadata": {
|
|
1002
|
-
"$ref": "#/components/schemas/metricMetadata"
|
|
1003
|
-
},
|
|
1004
|
-
"criticalValue": {
|
|
1005
|
-
"type": "number",
|
|
1006
|
-
"format": "double",
|
|
1007
|
-
"description": "The value that was computed during error correction. It is used to determine significance of the metric pValue.\nThe critical value is calculated using Bonferroni or Benjamini-Hochberg corrections, based on the given\nconfiguration during the A/B test creation.\n"
|
|
1008
|
-
},
|
|
1009
|
-
"significant": {
|
|
1010
|
-
"type": "boolean",
|
|
1011
|
-
"description": "Whether the pValue is significant or not based on the critical value and the error correction algorithm used.\n"
|
|
1012
|
-
}
|
|
1013
|
-
},
|
|
1014
|
-
"required": ["name", "updatedAt", "value", "pValue"],
|
|
1015
|
-
"example": [
|
|
1016
|
-
{
|
|
1017
|
-
"name": "addToCartCount",
|
|
1018
|
-
"updatedAt": "2025-06-15T15:06:44.400601Z",
|
|
1019
|
-
"value": 5,
|
|
1020
|
-
"pValue": 0.01
|
|
1021
|
-
},
|
|
1022
|
-
{
|
|
1023
|
-
"name": "clickThroughRate",
|
|
1024
|
-
"updatedAt": "2025-05-15T17:52:15.644906Z",
|
|
1025
|
-
"value": 0.20869847452125934,
|
|
1026
|
-
"pValue": 0.004
|
|
1027
|
-
},
|
|
1028
|
-
{
|
|
1029
|
-
"name": "revenue",
|
|
1030
|
-
"dimension": "USD",
|
|
1031
|
-
"updatedAt": "2025-05-15T17:52:15.644906Z",
|
|
1032
|
-
"value": 1200.5,
|
|
1033
|
-
"pValue": 0.04,
|
|
1034
|
-
"metadata": {
|
|
1035
|
-
"winsorizedValue": 80.2
|
|
1036
|
-
}
|
|
1037
|
-
},
|
|
1038
|
-
{
|
|
1039
|
-
"name": "revenue",
|
|
1040
|
-
"dimension": "EUR",
|
|
1041
|
-
"updatedAt": "2025-05-15T17:52:15.644906Z",
|
|
1042
|
-
"value": 999.66,
|
|
1043
|
-
"pValue": 0.04,
|
|
1044
|
-
"metadata": {
|
|
1045
|
-
"winsorizedValue": 888.8
|
|
1046
|
-
}
|
|
1047
|
-
}
|
|
1048
|
-
]
|
|
1049
|
-
},
|
|
1050
|
-
"metrics": {
|
|
1051
|
-
"type": "array",
|
|
1052
|
-
"description": "All ABTest metrics that were defined during test creation.",
|
|
1053
|
-
"items": {
|
|
1054
|
-
"$ref": "#/components/schemas/metricResult"
|
|
1055
|
-
}
|
|
1056
|
-
},
|
|
1057
|
-
"filterEffects": {
|
|
1058
|
-
"type": "object",
|
|
1059
|
-
"description": "A/B test filter effects resulting from configuration settings.",
|
|
1060
|
-
"properties": {
|
|
1061
|
-
"outliers": {
|
|
1062
|
-
"title": "outliersFilter",
|
|
1063
|
-
"type": "object",
|
|
1064
|
-
"description": "Outliers removed from the A/B test as a result of configuration settings.",
|
|
1065
|
-
"example": {
|
|
1066
|
-
"usersCount": 1,
|
|
1067
|
-
"trackedSearchesCount": 237
|
|
1068
|
-
},
|
|
1069
|
-
"properties": {
|
|
1070
|
-
"usersCount": {
|
|
1071
|
-
"type": "integer",
|
|
1072
|
-
"description": "Number of users removed from the A/B test.",
|
|
1073
|
-
"example": 1
|
|
1074
|
-
},
|
|
1075
|
-
"trackedSearchesCount": {
|
|
1076
|
-
"type": "integer",
|
|
1077
|
-
"description": "Number of tracked searches removed from the A/B test.",
|
|
1078
|
-
"example": 237
|
|
1079
|
-
}
|
|
1080
|
-
}
|
|
1081
|
-
},
|
|
1082
|
-
"emptySearch": {
|
|
1083
|
-
"title": "emptySearchFilter",
|
|
1084
|
-
"type": "object",
|
|
1085
|
-
"description": "Empty searches removed from the A/B test as a result of configuration settings.",
|
|
1086
|
-
"example": {
|
|
1087
|
-
"usersCount": 1,
|
|
1088
|
-
"trackedSearchesCount": 237
|
|
1089
|
-
},
|
|
1090
|
-
"properties": {
|
|
1091
|
-
"usersCount": {
|
|
1092
|
-
"type": "integer",
|
|
1093
|
-
"description": "Number of users removed from the A/B test.",
|
|
1094
|
-
"example": 1
|
|
1095
|
-
},
|
|
1096
|
-
"trackedSearchesCount": {
|
|
1097
|
-
"type": "integer",
|
|
1098
|
-
"description": "Number of tracked searches removed from the A/B test.",
|
|
1099
|
-
"example": 237
|
|
1100
|
-
}
|
|
1101
|
-
}
|
|
1102
|
-
}
|
|
1103
|
-
}
|
|
1104
|
-
},
|
|
1105
|
-
"variantMetadata": {
|
|
1106
|
-
"type": "object",
|
|
1107
|
-
"description": "Variant specific metadata.",
|
|
1108
|
-
"properties": {
|
|
1109
|
-
"filterEffects": {
|
|
1110
|
-
"$ref": "#/components/schemas/filterEffects"
|
|
1111
|
-
}
|
|
1112
|
-
}
|
|
1113
|
-
},
|
|
1114
|
-
"variant": {
|
|
1115
|
-
"type": "object",
|
|
1116
|
-
"additionalProperties": false,
|
|
1117
|
-
"properties": {
|
|
1118
|
-
"description": {
|
|
1119
|
-
"$ref": "#/components/schemas/description"
|
|
1120
|
-
},
|
|
1121
|
-
"estimatedSampleSize": {
|
|
1122
|
-
"type": "integer",
|
|
1123
|
-
"description": "Estimated number of searches required to achieve the desired statistical significance.\n\nThe A/B test configuration must include a `minimumDetectableEffect` setting for this number to be included in the response.\n",
|
|
1124
|
-
"example": 0
|
|
1125
|
-
},
|
|
1126
|
-
"index": {
|
|
1127
|
-
"$ref": "#/components/schemas/index"
|
|
1128
|
-
},
|
|
1129
|
-
"trafficPercentage": {
|
|
1130
|
-
"$ref": "#/components/schemas/trafficPercentage"
|
|
1131
|
-
},
|
|
1132
|
-
"metrics": {
|
|
1133
|
-
"$ref": "#/components/schemas/metrics"
|
|
1134
|
-
},
|
|
1135
|
-
"metadata": {
|
|
1136
|
-
"$ref": "#/components/schemas/variantMetadata"
|
|
1137
|
-
},
|
|
1138
|
-
"customSearchParameters": {
|
|
1139
|
-
"type": "object",
|
|
1140
|
-
"description": "Search parameters applied to this variant when the same index is used for multiple variants.\nOnly present if custom search parameters were provided during test creation.\n",
|
|
1141
|
-
"example": {
|
|
1142
|
-
"enablePersonalization": true,
|
|
1143
|
-
"personalizationImpact": 50
|
|
1144
|
-
}
|
|
1145
|
-
}
|
|
1146
|
-
},
|
|
1147
|
-
"required": ["index", "description", "trafficPercentage", "metrics"]
|
|
1148
|
-
},
|
|
1149
|
-
"variants": {
|
|
1150
|
-
"type": "array",
|
|
1151
|
-
"description": "A/B test variants.\n\nThe first variant is your _control_ index, typically your production index.\nAll of the additional variants are indexes with changed settings that you want to test against the control.\n",
|
|
1152
|
-
"items": {
|
|
1153
|
-
"$ref": "#/components/schemas/variant"
|
|
1154
|
-
}
|
|
1155
|
-
},
|
|
1156
|
-
"EffectMetric": {
|
|
1157
|
-
"type": "string",
|
|
1158
|
-
"description": "Metric for which you want to detect the smallest relative difference.",
|
|
1159
|
-
"enum": [
|
|
1160
|
-
"addToCartRate",
|
|
1161
|
-
"clickThroughRate",
|
|
1162
|
-
"conversionRate",
|
|
1163
|
-
"purchaseRate",
|
|
1164
|
-
"noResultsRate"
|
|
1165
|
-
]
|
|
1166
|
-
},
|
|
1167
|
-
"MinimumDetectableEffect": {
|
|
1168
|
-
"type": "object",
|
|
1169
|
-
"description": "Configuration for the smallest difference between test variants you want to detect.",
|
|
1170
|
-
"properties": {
|
|
1171
|
-
"size": {
|
|
1172
|
-
"type": "number",
|
|
1173
|
-
"format": "double",
|
|
1174
|
-
"minimum": 0,
|
|
1175
|
-
"maximum": 1,
|
|
1176
|
-
"description": "Smallest difference in an observable metric between variants.\nFor example, to detect a 10% difference between variants, set this value to 0.1.\n"
|
|
1177
|
-
},
|
|
1178
|
-
"metric": {
|
|
1179
|
-
"$ref": "#/components/schemas/EffectMetric"
|
|
1180
|
-
}
|
|
1181
|
-
},
|
|
1182
|
-
"required": ["size", "metric"]
|
|
1183
|
-
},
|
|
1184
|
-
"MetricsFilter": {
|
|
1185
|
-
"type": "object",
|
|
1186
|
-
"additionalProperties": false,
|
|
1187
|
-
"description": "Boolean filter applied to the A/B test population. Each filter targets a boolean metric\nand decides whether to include (true) or exclude (false) matching records.\n",
|
|
1188
|
-
"properties": {
|
|
1189
|
-
"domain": {
|
|
1190
|
-
"type": "string",
|
|
1191
|
-
"description": "Metric domain (for example `abtesting`, `personalization`).",
|
|
1192
|
-
"example": "abtesting"
|
|
1193
|
-
},
|
|
1194
|
-
"name": {
|
|
1195
|
-
"type": "string",
|
|
1196
|
-
"description": "Public metric name.",
|
|
1197
|
-
"example": "isOutlier"
|
|
1198
|
-
},
|
|
1199
|
-
"trackEffects": {
|
|
1200
|
-
"type": "boolean",
|
|
1201
|
-
"description": "Whether the experiment should record the effects of this filter."
|
|
1202
|
-
},
|
|
1203
|
-
"includes": {
|
|
1204
|
-
"type": "boolean",
|
|
1205
|
-
"description": "If true, keep items that match the filter; if false, exclude them."
|
|
1206
|
-
}
|
|
1207
|
-
},
|
|
1208
|
-
"required": ["domain", "name"]
|
|
1209
|
-
},
|
|
1210
|
-
"MetricsFilters": {
|
|
1211
|
-
"type": "array",
|
|
1212
|
-
"description": "List of metric filters applied to the test population.",
|
|
1213
|
-
"items": {
|
|
1214
|
-
"$ref": "#/components/schemas/MetricsFilter"
|
|
1215
|
-
}
|
|
1216
|
-
},
|
|
1217
|
-
"ErrorCorrectionType": {
|
|
1218
|
-
"type": "string",
|
|
1219
|
-
"description": "Multiple-testing correction method applied when evaluating metric significance.",
|
|
1220
|
-
"enum": ["bonferroni", "benjamini-hochberg"]
|
|
1221
|
-
},
|
|
1222
|
-
"ABTestConfiguration": {
|
|
1223
|
-
"title": "configuration",
|
|
1224
|
-
"type": "object",
|
|
1225
|
-
"description": "A/B test configuration.",
|
|
1226
|
-
"properties": {
|
|
1227
|
-
"minimumDetectableEffect": {
|
|
1228
|
-
"$ref": "#/components/schemas/MinimumDetectableEffect"
|
|
1229
|
-
},
|
|
1230
|
-
"filters": {
|
|
1231
|
-
"$ref": "#/components/schemas/MetricsFilters"
|
|
1232
|
-
},
|
|
1233
|
-
"errorCorrection": {
|
|
1234
|
-
"$ref": "#/components/schemas/ErrorCorrectionType"
|
|
1235
|
-
}
|
|
1236
|
-
}
|
|
1237
|
-
},
|
|
1238
|
-
"MigratedABTestId": {
|
|
1239
|
-
"type": "integer",
|
|
1240
|
-
"description": "Unique migrated A/B test identifier.",
|
|
1241
|
-
"example": 224
|
|
1242
|
-
},
|
|
1243
|
-
"ABTest": {
|
|
1244
|
-
"type": "object",
|
|
1245
|
-
"additionalProperties": false,
|
|
1246
|
-
"properties": {
|
|
1247
|
-
"abTestID": {
|
|
1248
|
-
"$ref": "#/components/schemas/abTestID"
|
|
1249
|
-
},
|
|
1250
|
-
"updatedAt": {
|
|
1251
|
-
"$ref": "#/components/schemas/updatedAt"
|
|
1252
|
-
},
|
|
1253
|
-
"createdAt": {
|
|
1254
|
-
"$ref": "#/components/schemas/createdAt"
|
|
1255
|
-
},
|
|
1256
|
-
"endAt": {
|
|
1257
|
-
"$ref": "#/components/schemas/endAt"
|
|
1258
|
-
},
|
|
1259
|
-
"stoppedAt": {
|
|
1260
|
-
"$ref": "#/components/schemas/stoppedAt"
|
|
1261
|
-
},
|
|
1262
|
-
"name": {
|
|
1263
|
-
"$ref": "#/components/schemas/name"
|
|
1264
|
-
},
|
|
1265
|
-
"status": {
|
|
1266
|
-
"$ref": "#/components/schemas/Status"
|
|
1267
|
-
},
|
|
1268
|
-
"variants": {
|
|
1269
|
-
"$ref": "#/components/schemas/variants"
|
|
1270
|
-
},
|
|
1271
|
-
"configuration": {
|
|
1272
|
-
"$ref": "#/components/schemas/ABTestConfiguration"
|
|
1273
|
-
},
|
|
1274
|
-
"migratedAbTestID": {
|
|
1275
|
-
"$ref": "#/components/schemas/MigratedABTestId"
|
|
1276
|
-
}
|
|
1277
|
-
},
|
|
1278
|
-
"required": ["status", "name", "createdAt", "endAt", "updatedAt", "abTestID", "variants"]
|
|
1279
|
-
},
|
|
1280
|
-
"ABTests": {
|
|
1281
|
-
"oneOf": [
|
|
1282
|
-
{
|
|
1283
|
-
"type": "array",
|
|
1284
|
-
"description": "A/B tests.",
|
|
1285
|
-
"items": {
|
|
1286
|
-
"$ref": "#/components/schemas/ABTest"
|
|
1287
|
-
}
|
|
1288
|
-
},
|
|
1289
|
-
{
|
|
1290
|
-
"type": "null"
|
|
1291
|
-
}
|
|
1292
|
-
]
|
|
1293
|
-
},
|
|
1294
|
-
"abTestsVariant": {
|
|
1295
|
-
"type": "object",
|
|
1296
|
-
"additionalProperties": false,
|
|
1297
|
-
"properties": {
|
|
1298
|
-
"index": {
|
|
1299
|
-
"$ref": "#/components/schemas/index"
|
|
1300
|
-
},
|
|
1301
|
-
"trafficPercentage": {
|
|
1302
|
-
"$ref": "#/components/schemas/trafficPercentage"
|
|
1303
|
-
},
|
|
1304
|
-
"description": {
|
|
1305
|
-
"$ref": "#/components/schemas/description"
|
|
1306
|
-
}
|
|
1307
|
-
},
|
|
1308
|
-
"required": ["index", "trafficPercentage"]
|
|
1309
|
-
},
|
|
1310
|
-
"customSearchParams": {
|
|
1311
|
-
"type": "object",
|
|
1312
|
-
"description": "Search parameters to add to the test variant.\nOnly use this parameter if the two variants use the same index.\n",
|
|
1313
|
-
"example": {
|
|
1314
|
-
"typoTolerance": false,
|
|
1315
|
-
"synonyms": false
|
|
1316
|
-
},
|
|
1317
|
-
"additionalProperties": false,
|
|
1318
|
-
"properties": {
|
|
1319
|
-
"customSearchParameters": {
|
|
1320
|
-
"type": "object"
|
|
1321
|
-
}
|
|
1322
|
-
},
|
|
1323
|
-
"required": ["customSearchParameters"],
|
|
1324
|
-
"x-discriminator-fields": ["customSearchParameters"]
|
|
1325
|
-
},
|
|
1326
|
-
"abTestsVariantSearchParams": {
|
|
1327
|
-
"allOf": [
|
|
1328
|
-
{
|
|
1329
|
-
"$ref": "#/components/schemas/abTestsVariant"
|
|
1330
|
-
},
|
|
1331
|
-
{
|
|
1332
|
-
"$ref": "#/components/schemas/customSearchParams"
|
|
1333
|
-
}
|
|
1334
|
-
]
|
|
1335
|
-
},
|
|
1336
|
-
"AddABTestsVariant": {
|
|
1337
|
-
"oneOf": [
|
|
1338
|
-
{
|
|
1339
|
-
"$ref": "#/components/schemas/abTestsVariant"
|
|
1340
|
-
},
|
|
1341
|
-
{
|
|
1342
|
-
"$ref": "#/components/schemas/abTestsVariantSearchParams"
|
|
1343
|
-
}
|
|
1344
|
-
]
|
|
1345
|
-
},
|
|
1346
|
-
"createMetric": {
|
|
1347
|
-
"type": "object",
|
|
1348
|
-
"description": "Defines a metric to be retrieved during an A/B test.",
|
|
1349
|
-
"properties": {
|
|
1350
|
-
"name": {
|
|
1351
|
-
"type": "string",
|
|
1352
|
-
"description": "Name of the metric."
|
|
1353
|
-
},
|
|
1354
|
-
"dimension": {
|
|
1355
|
-
"type": "string",
|
|
1356
|
-
"description": "Dimension of the metric, for example, in case of a revenue metric it could be USD, EUR..."
|
|
1357
|
-
}
|
|
1358
|
-
},
|
|
1359
|
-
"required": ["name"],
|
|
1360
|
-
"example": [
|
|
1361
|
-
{
|
|
1362
|
-
"name": "revenue",
|
|
1363
|
-
"dimension": "USD"
|
|
1364
|
-
},
|
|
1365
|
-
{
|
|
1366
|
-
"name": "conversionRate"
|
|
1367
|
-
},
|
|
1368
|
-
{
|
|
1369
|
-
"name": "clickThroughRate"
|
|
1370
|
-
},
|
|
1371
|
-
{
|
|
1372
|
-
"name": "trackedSearchCount"
|
|
1373
|
-
}
|
|
1374
|
-
]
|
|
1375
|
-
},
|
|
1376
|
-
"taskID": {
|
|
1377
|
-
"type": "integer",
|
|
1378
|
-
"format": "int64",
|
|
1379
|
-
"example": 1514562690001,
|
|
1380
|
-
"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"
|
|
1381
|
-
},
|
|
1382
|
-
"ABTestResponse": {
|
|
1383
|
-
"type": "object",
|
|
1384
|
-
"additionalProperties": false,
|
|
1385
|
-
"properties": {
|
|
1386
|
-
"index": {
|
|
1387
|
-
"$ref": "#/components/schemas/index"
|
|
1388
|
-
},
|
|
1389
|
-
"abTestID": {
|
|
1390
|
-
"$ref": "#/components/schemas/abTestID"
|
|
1391
|
-
},
|
|
1392
|
-
"taskID": {
|
|
1393
|
-
"$ref": "#/components/schemas/taskID"
|
|
1394
|
-
}
|
|
1395
|
-
},
|
|
1396
|
-
"required": ["abTestID", "index", "taskID"]
|
|
1397
|
-
},
|
|
1398
|
-
"scheduledAt": {
|
|
1399
|
-
"type": "string",
|
|
1400
|
-
"description": "Date and time when the A/B test is scheduled to start, in RFC 3339 format.",
|
|
1401
|
-
"example": "2023-06-15T15:06:44.400601Z"
|
|
1402
|
-
},
|
|
1403
|
-
"abTestScheduleID": {
|
|
1404
|
-
"type": "integer",
|
|
1405
|
-
"description": "Unique scheduled A/B test identifier.",
|
|
1406
|
-
"example": 224
|
|
1407
|
-
},
|
|
1408
|
-
"ScheduleABTestResponse": {
|
|
1409
|
-
"type": "object",
|
|
1410
|
-
"additionalProperties": false,
|
|
1411
|
-
"properties": {
|
|
1412
|
-
"abTestScheduleID": {
|
|
1413
|
-
"$ref": "#/components/schemas/abTestScheduleID"
|
|
1414
|
-
}
|
|
1415
|
-
},
|
|
1416
|
-
"required": ["abTestScheduleID"]
|
|
1417
|
-
},
|
|
1418
|
-
"EstimateABTestResponse": {
|
|
1419
|
-
"type": "object",
|
|
1420
|
-
"properties": {
|
|
1421
|
-
"durationDays": {
|
|
1422
|
-
"type": "integer",
|
|
1423
|
-
"format": "int64",
|
|
1424
|
-
"description": "Estimated number of days needed to reach the sample sizes required for detecting the configured effect. This value is based on historical traffic.",
|
|
1425
|
-
"example": 21
|
|
1426
|
-
},
|
|
1427
|
-
"sampleSizes": {
|
|
1428
|
-
"type": "array",
|
|
1429
|
-
"description": "Sample size estimates for each variant. The first element is the control variant.\nEach element is the estimated number of searches required to achieve the desired statistical significance.\n",
|
|
1430
|
-
"items": {
|
|
1431
|
-
"type": "integer",
|
|
1432
|
-
"format": "int64",
|
|
1433
|
-
"description": "Number of tracked searches needed to be able to detect the configured effect for the control variant.",
|
|
1434
|
-
"example": 23415
|
|
1435
|
-
}
|
|
1436
|
-
}
|
|
1437
|
-
}
|
|
1438
|
-
},
|
|
1439
|
-
"MetricName": {
|
|
1440
|
-
"type": "string",
|
|
1441
|
-
"enum": [
|
|
1442
|
-
"search_count",
|
|
1443
|
-
"tracked_search_count",
|
|
1444
|
-
"user_count",
|
|
1445
|
-
"tracked_user_count",
|
|
1446
|
-
"no_result_count",
|
|
1447
|
-
"add_to_cart_count",
|
|
1448
|
-
"purchase_count",
|
|
1449
|
-
"clicked_search_count",
|
|
1450
|
-
"converted_search_count",
|
|
1451
|
-
"click_through_rate",
|
|
1452
|
-
"conversion_rate",
|
|
1453
|
-
"add_to_cart_rate",
|
|
1454
|
-
"purchase_rate",
|
|
1455
|
-
"average_click_position",
|
|
1456
|
-
"revenue"
|
|
1457
|
-
]
|
|
1458
|
-
},
|
|
1459
|
-
"metricDate": {
|
|
1460
|
-
"type": "object",
|
|
1461
|
-
"properties": {
|
|
1462
|
-
"date": {
|
|
1463
|
-
"type": "string",
|
|
1464
|
-
"description": "Date where the metric was updated, in RFC 3339 format.",
|
|
1465
|
-
"example": "2025-06-15"
|
|
1466
|
-
},
|
|
1467
|
-
"metrics": {
|
|
1468
|
-
"$ref": "#/components/schemas/metrics"
|
|
1469
|
-
}
|
|
1470
|
-
}
|
|
1471
|
-
},
|
|
1472
|
-
"metricDates": {
|
|
1473
|
-
"type": "array",
|
|
1474
|
-
"items": {
|
|
1475
|
-
"$ref": "#/components/schemas/metricDate"
|
|
1476
|
-
}
|
|
1477
|
-
},
|
|
1478
|
-
"timeseriesVariant": {
|
|
1479
|
-
"type": "object",
|
|
1480
|
-
"properties": {
|
|
1481
|
-
"dates": {
|
|
1482
|
-
"$ref": "#/components/schemas/metricDates"
|
|
1483
|
-
}
|
|
1484
|
-
}
|
|
1485
|
-
},
|
|
1486
|
-
"timeseriesVariants": {
|
|
1487
|
-
"type": "array",
|
|
1488
|
-
"description": "A/B test timeseries variants.\n\nThe first variant is your _control_ index, typically your production index.\nAll of the additional variants are indexes with changed settings that you want to test against the control.\n",
|
|
1489
|
-
"items": {
|
|
1490
|
-
"$ref": "#/components/schemas/timeseriesVariant"
|
|
1491
|
-
}
|
|
1492
|
-
},
|
|
1493
|
-
"Timeseries": {
|
|
1494
|
-
"type": "object",
|
|
1495
|
-
"additionalProperties": false,
|
|
1496
|
-
"properties": {
|
|
1497
|
-
"abTestID": {
|
|
1498
|
-
"$ref": "#/components/schemas/abTestID"
|
|
1499
|
-
},
|
|
1500
|
-
"variants": {
|
|
1501
|
-
"$ref": "#/components/schemas/timeseriesVariants"
|
|
1502
|
-
}
|
|
1503
|
-
},
|
|
1504
|
-
"required": ["abTestID", "variants"]
|
|
1505
|
-
}
|
|
1506
|
-
},
|
|
1507
|
-
"responses": {
|
|
1508
|
-
"BadRequest": {
|
|
1509
|
-
"description": "Bad request or request arguments.",
|
|
1510
|
-
"content": {
|
|
1511
|
-
"application/json": {
|
|
1512
|
-
"schema": {
|
|
1513
|
-
"$ref": "#/components/schemas/ErrorBase"
|
|
1514
|
-
}
|
|
1515
|
-
}
|
|
1516
|
-
}
|
|
1517
|
-
},
|
|
1518
|
-
"FeatureNotEnabled": {
|
|
1519
|
-
"description": "This feature is not enabled on your Algolia account.",
|
|
1520
|
-
"content": {
|
|
1521
|
-
"application/json": {
|
|
1522
|
-
"schema": {
|
|
1523
|
-
"$ref": "#/components/schemas/ErrorBase"
|
|
1524
|
-
}
|
|
1525
|
-
}
|
|
1526
|
-
}
|
|
1527
|
-
},
|
|
1528
|
-
"MethodNotAllowed": {
|
|
1529
|
-
"description": "Method not allowed with this API key.",
|
|
1530
|
-
"content": {
|
|
1531
|
-
"application/json": {
|
|
1532
|
-
"schema": {
|
|
1533
|
-
"$ref": "#/components/schemas/ErrorBase"
|
|
1534
|
-
}
|
|
1535
|
-
}
|
|
1536
|
-
}
|
|
1537
|
-
},
|
|
1538
|
-
"IndexNotFound": {
|
|
1539
|
-
"description": "Index not found.",
|
|
1540
|
-
"content": {
|
|
1541
|
-
"application/json": {
|
|
1542
|
-
"schema": {
|
|
1543
|
-
"$ref": "#/components/schemas/ErrorBase"
|
|
1544
|
-
}
|
|
1545
|
-
}
|
|
1546
|
-
}
|
|
1547
|
-
},
|
|
1548
|
-
"UnprocessableEntity": {
|
|
1549
|
-
"description": "Unprocessable Entity.",
|
|
1550
|
-
"content": {
|
|
1551
|
-
"application/json": {
|
|
1552
|
-
"schema": {
|
|
1553
|
-
"$ref": "#/components/schemas/ErrorBase"
|
|
1554
|
-
}
|
|
1555
|
-
}
|
|
1556
|
-
}
|
|
1557
|
-
}
|
|
1558
|
-
},
|
|
1559
|
-
"headers": {
|
|
1560
|
-
"x-ratelimit-limit": {
|
|
1561
|
-
"description": "Number of allowed requests per one minute.",
|
|
1562
|
-
"example": 100,
|
|
1563
|
-
"schema": {
|
|
1564
|
-
"type": "integer"
|
|
1565
|
-
}
|
|
1566
|
-
},
|
|
1567
|
-
"x-ratelimit-remaining": {
|
|
1568
|
-
"description": "Number of remaining requests in the current period.",
|
|
1569
|
-
"example": 99,
|
|
1570
|
-
"schema": {
|
|
1571
|
-
"type": "integer"
|
|
1572
|
-
}
|
|
1573
|
-
},
|
|
1574
|
-
"x-ratelimit-reset": {
|
|
1575
|
-
"description": "Timstamp when the rate limit will reset, measured in seconds since the Unix epoch.",
|
|
1576
|
-
"example": 1710682486,
|
|
1577
|
-
"schema": {
|
|
1578
|
-
"type": "integer"
|
|
1579
|
-
}
|
|
1580
|
-
}
|
|
1581
|
-
}
|
|
1582
|
-
},
|
|
1583
|
-
"x-tagGroups": [
|
|
1584
|
-
{
|
|
1585
|
-
"name": "General",
|
|
1586
|
-
"tags": ["abtest"]
|
|
1587
|
-
}
|
|
1588
|
-
]
|
|
1589
|
-
}
|