Documentation menu

API Reference

Activity

Durable, tenant-scoped activity log (history/query)

GET /api/plugin/activity

Query the activity log

Keyset-paginated, newest-first. Filters: playerUuid, type, category, serverId, since/until (epoch ms). Returns { items: [...], nextCursor }; pass nextCursor back as cursor for the next page (null when exhausted).

Parameters

  • category string query
  • cursor string query
  • limit integer query
  • playerUuid string query
  • serverId string query
  • since integer query
  • type string query
  • until integer query

Responses

  • 200 OK
200 response
[
  {
    "empty": false,
    "valueNode": false,
    "containerNode": false,
    "missingNode": false,
    "array": false,
    "object": false,
    "nodeType": "ARRAY",
    "pojo": false,
    "number": false,
    "integralNumber": false,
    "floatingPointNumber": false,
    "short": false,
    "int": false,
    "long": false,
    "float": false,
    "double": false,
    "bigDecimal": false,
    "bigInteger": false,
    "textual": false,
    "boolean": false,
    "null": false,
    "binary": false
  }
]

Request

~
curl -X GET http://localhost:8090/api/plugin/activity?category=value&cursor=value&limit=0&playerUuid=value&serverId=value&since=0&type=value&until=0 \
  -H "X-Hive-Api-Key: $HIVE_API_KEY"
hive.activity().query(ActivityQuery.builder()
    .playerUuid(playerUuid)
    .build())
  .thenAccept(page -> { /* page.items(), page.nextCursor() */ });