feat: openapi sample with search, index, and batch API

openapi_spec/parameters.yml

@@ -0,0 +1,26 @@
+AppId:
+  name: X-Algolia-Application-Id
+  in: header
+  description: Algolia appID
+  required: true
+  schema:
+    type: string
+    pattern: "^(?:beta|testing)?[A-Z0-9]{10}$"
+    example: "DJNVGS47DK"
+ApiKey:
+  name: X-Algolia-API-Key
+  in: header
+  description: Algolia API key
+  required: true
+  schema:
+    type: string
+    pattern: "^[a-f0-9]{32}$"
+    example: "43b15df305339e827f0ac0bdc5ebcaa7"
+IndexName:
+  name: indexName
+  in: path
+  description: The index in which to perform the request
+  required: true
+  schema:
+    type: string
+    example: "myIndexName"

openapi_spec/paths/indexes/batch.yml

@@ -0,0 +1,58 @@
+post:
+  tags:
+    - object
+  operationId: batch
+  summary: Performs multiple write operations in a single API call
+  parameters:
+    - $ref: "../../parameters.yml#/AppId"
+    - $ref: "../../parameters.yml#/ApiKey"
+    - $ref: "../../parameters.yml#/IndexName"
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          type: object
+          properties:
+            requests:
+              type: array
+              items:
+                title: operation
+                type: object
+                additionalProperties: false
+                properties:
+                  action:
+                    type: string
+                    enum:
+                      - "addObject"
+                      - "updateObject"
+                      - "partialUpdateObject"
+                      - "partialUpdateObjectNoCreate"
+                      - "deleteObject"
+                      - "delete"
+                      - "clear"
+                    description: type of operation
+                  body:
+                    type: object
+                    # this could be a long oneOf with every possibilities
+                    additionalProperties: true
+                    description: arguments to the operation (depends on the type of the operation)
+  responses:
+    "200":
+      description: OK
+      content:
+        application/json:
+          schema:
+            type: object
+            additionalProperties: false
+            properties:
+              taskID:
+                type: integer
+              objectIDs:
+                type: array
+                items:
+                  type: string
+    "400":
+      $ref: "../../responses/BadRequest.yml"
+    "404":
+      $ref: "../../responses/IndexNotFound.yml"

openapi_spec/paths/indexes/saveObject.yml

@@ -0,0 +1,36 @@
+post:
+  tags:
+    - object
+  operationId: saveObject
+  summary: Save object
+  description: Add an object to the index, automatically assigning it an object ID
+  parameters:
+    - $ref: "../../parameters.yml#/AppId"
+    - $ref: "../../parameters.yml#/ApiKey"
+    - $ref: "../../parameters.yml#/IndexName"
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          type: object
+          additionalProperties: true
+  responses:
+    "200":
+      description: OK
+      content:
+        application/json:
+          schema:
+            type: object
+            additionalProperties: false
+            properties:
+              createdAt:
+                type: string
+              taskID:
+                type: integer
+              objectID:
+                type: string
+    "400":
+      $ref: "../../responses/BadRequest.yml"
+    "404":
+      $ref: "../../responses/IndexNotFound.yml"

openapi_spec/paths/indexes/search.yml

@@ -0,0 +1,40 @@
+post:
+  tags:
+    - search
+  operationId: search
+  summary: Get search results
+  parameters:
+    - $ref: "../../parameters.yml#/AppId"
+    - $ref: "../../parameters.yml#/ApiKey"
+    - $ref: "../../parameters.yml#/IndexName"
+  requestBody:
+    $ref: "../../schemas/SearchParams.yml"
+  responses:
+    "200":
+      description: OK
+      content:
+        application/json:
+          schema:
+            title: singleQueryResponse
+            type: object
+            additionalProperties: false
+            properties:
+              hits:
+                type: array
+                items:
+                  type: object
+                  additionalProperties: false
+                  properties:
+                    objectID:
+                      type: string
+                      example: objectID1
+              nbHits:
+                type: integer
+              queryID:
+                type: string
+                pattern: "[a-f0-9]{32}"
+                example: 43b15df305339e827f0ac0bdc5ebcaa7
+    "400":
+      $ref: "../../responses/BadRequest.yml"
+    "404":
+      $ref: "../../responses/IndexNotFound.yml"

openapi_spec/paths/indexes/searchMulti.yml

@@ -0,0 +1,83 @@
+post:
+  tags:
+    - search
+  operationId: searchMulti
+  summary: Get search results for the given requests.
+  parameters:
+    - $ref: "../../parameters.yml#/AppId"
+    - $ref: "../../parameters.yml#/ApiKey"
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          type: object
+          additionalProperties: false
+          properties:
+            requests:
+              type: array
+              items:
+                title: multipleQueries
+                type: object
+                additionalProperties: false
+                properties:
+                  indexName:
+                    type: string
+                    example: products
+                    description: The Algolia index name
+                  query:
+                    type: string
+                    description: The query to search for
+                  type:
+                    type: string
+                    enum: [default, facet]
+                    default: default
+                    description: Perform a search query with `default`, will search for facet values if `facet` is given
+                  facet:
+                    type: string
+                    description: The `facet` name
+                  params:
+                    type: string
+                    description: A query string of search parameters
+                required:
+                  - indexName
+            strategy:
+              type: string
+              enum: ["none", "stopIfEnoughMatches"]
+          required:
+            - requests
+  responses:
+    "200":
+      description: OK
+      content:
+        application/json:
+          schema:
+            title: multipleQueriesResponse
+            type: object
+            additionalProperties: false
+            properties:
+              results:
+                type: array
+                items:
+                  type: object
+                  additionalProperties: false
+                  properties:
+                    hits:
+                      type: array
+                      items:
+                        type: object
+                        additionalProperties: false
+                        properties:
+                          objectID:
+                            type: string
+                            example: objectID1
+                    nbHits:
+                      type: integer
+                    queryID:
+                      type: string
+                      pattern: "[a-f0-9]{32}"
+                      example: 43b15df305339e827f0ac0bdc5ebcaa7
+    "400":
+      $ref: "../../responses/BadRequest.yml"
+    "404":
+      $ref: "../../responses/IndexNotFound.yml"

openapi_spec/responses/BadRequest.yml

@@ -0,0 +1,5 @@
+description: Bad request or request arguments
+content:
+  application/json:
+    schema:
+      $ref: "../schemas/Error.yml"

openapi_spec/responses/IndexNotFound.yml

@@ -0,0 +1,5 @@
+description: Index not found
+content:
+  application/json:
+    schema:
+      $ref: "../schemas/Error.yml"

openapi_spec/schemas/Error.yml

@@ -0,0 +1,7 @@
+description: Error
+type: object
+additionalProperties: true
+properties:
+  message:
+    type: string
+    example: "Invalid application id"