POST cron/5

Periodically execute tasks (but only once per period, regardless of how many API servers are in the fleet). This method will be called every five minutes by a CloudWatch Rule. Whichever API server receives the request fires a node event which is consumed by modules that need to perform periodic tasks. As of writing, those tasks are:

  1. Delete games which were created but never joined. Such games have zero connected players and are older than twice the host connection timeout. (Past that timeout, no one will ever be able to connect.)
  2. Detect stale activity records (those not updated since the activity heartbeat timeout). Delete them and fire an offline activity update.

Example

POST /api/v1/cron/5 HTTP/1.1
Authorization: Signature ...
Content-Type: application/json

{
  "foo": "bar"
}
----------------------------------------
HTTP/1.1 204 No Content
ETag: W/"a-bAsFyilMr4Ra1hIU5PyoyFRunpI"

Security

Authentication is required and restricted to system processes. Requests should be signed using a System key.

URL Parameters

NONE

Request Body

The request body is an arbitrary object for signature purposes only. Its contents are not inspected.

Response

Successful responses are code 204. Error responses are standard.

Response Body

NONE