API Reference

Welcome to the DYMOL API. Our endpoints are designed to be fast, strictly isolated per project, and simple to implement in any game engine or web framework.

Authentication

Every request to the DYMOL API requires a Bearer token provided by Unkey.dev. You must pass this key in the Authorization header.

Authorization: Bearer dymol_sk_...

ReactionAPI

POST /v1/react

Submit or update a user's reaction to a specific target (level, post, item). This endpoint uses an upsert strategy: if the same user reacts again to the same target, their previous reaction is updated.

Request Body

{
  "target_id": "level_99",
  "type": "fire",
  "user_id": "player_123"
}

GET /v1/reactions

Retrieve a global aggregation of all reactions across your entire project, broken down by target_id.

Response

{
  "success": true,
  "data": {
    "total_reactions": 3,
    "global_distribution": {
      "fire": 2,
      "heart": 1
    },
    "targets": {
      "level_99": {
        "fire": 1
      },
      "junk_20": {
        "fire": 1,
        "heart": 1
      }
    }
  }
}