Core
API v1.x
1

You are currently looking at the documentation of a previous version of Kuzzle. We strongly recommend that you use the latest version. You can also use the version selector in the top menu.

scrollSpecifications #

Moves a result set cursor forward, created by the searchSpecifications request when the scroll argument is provided.

Results returned by a scroll request reflect the state of the index at the time of the initial search request, like a fixed snapshot. Subsequent changes to documents do not affect the scroll results.


Query Syntax #

HTTP #

Copied to clipboard!
URL: http://kuzzle:7512/validations/_scroll/<scrollId>[?scroll=<time to live>]
Method: GET

Other protocols #

Copied to clipboard!
{
  "controller": "collections",
  "action": "scrollSpecifications",
  "scrollId": "<scrollId>",
  "scroll": "<time to live>"
}

Arguments #

  • collection: collection name
  • index: index name
  • scrollId: cursor identifier, obtained with (/core/1/api/controllers/collection/search-specifications)

Optional: #

  • scroll: reset the cursor TTL to the provided duration, using the time to live format.

Response #

Returns an object containing the following properties:

  • hits: an array of found documents. Each item is an object with the following properties:
    • _id: specification unique identifier
    • _score: search pertinence score
    • _source: validation specification
  • scrollId: the cursor unique identifier for the next page of results. Scroll requests may return a new scroll identifier, so only the most recent one should be used
  • total: the total number of found specifications (usually greater than the number of items in the hits array)

Example:

Copied to clipboard!
{
  "status": 200,
  "error": null,
  "action": "scrollSpecifications",
  "controller": "collection",
  "requestId": "<unique request identifier>",
  "result": {
    "scrollId": "<new scroll id>",
    "hits": [
      {
        "_id": "<specification unique ID>",
        "_score": 1,
        "_source": {
          "collection": "myCollection",
          "index": "myIndex",
          "validation": {
            "fields": {
              "fieldName": {
                "defaultValue": "a default value",
                "mandatory": true,
                "multivalued": {
                  "maxCount": 5,
                  "minCount": 1,
                  "value": true
                },
                "type": "string",
                "typeOptions": {
                  "length": {
                    "max": 12,
                    "min": 2
                  }
                }
              }
            },
            "strict": true
          }
        }
      }
    ],
    "total": 42
  }
}

Possible errors #