execute #

Executes a Kuzzle's API action.

The execute function main usage is to forward users API requests to Kuzzle.

Arguments #

execute(connection, request, callback);

Arguments	Type	Description
`connection`	ClientConnection	Connection the request comes from, previously registered with newConnection
`request`	Request	Standardized API request
`callback(result)`	function	Required. Callback receiving the response

Return #

The execute function does not return a value: it calls callback with a serialized Kuzzle response JSON object.

This object contains the following properties:

raw (boolean, default false): if false, the response content is a JSON object following the Kuzzle standard response format. Otherwise, the content can be anything, depending on the executed API action.
status (integer, default 200): request status, following the standard HTTP status codes
requestId (string, nullable): request identifier set by clients, and used to link asynchronous responses to emitted requests.
content: the response itself, this is the payload that should be sent to the requesting client following the implemented protocol format. This property type partly depends on the value of the raw flag (if false, then the content is always a JSON object).
headers (JSON object, default {}): custom headers/optional response properties that can be added by the executed API action. Whether the protocol interprets and uses them depends on its nature and implementation.

Example #

const request = new context.Request({
  controller: 'server',
  action: 'now'
}, { connection });

entryPoint.execute(connection, request, result => {
  // Content example for the result object:
  // 
  // { 
  //   "raw": false,
  //   "status": 200,
  //   "requestId": "b0eec0b9-f458-4ec8-8aee-b86d7a922290",
  //   "content": { 
  //     "requestId": "b0eec0b9-f458-4ec8-8aee-b86d7a922290",
  //     "status": 200,
  //     "error": null,
  //     "controller": "server",
  //     "action": "now",
  //     "collection": null,
  //     "index": null,
  //     "volatile": null,
  //     "result": { "now": 1564644834036 } 
  //   },
  //   "headers": { 
  //     "content-type": "application/json",
  //     "Accept-Encoding": "gzip,deflate,identity",
  //     "Access-Control-Allow-Origin": "*",
  //     "Access-Control-Allow-Methods": "GET,POST,PUT,DELETE,OPTIONS,HEAD"
  //   } 
  // }
});