Skip to main content

There are two different architecture types to integrate Idem into you game. For details see Architecture.

Setting up Server-based

In the Server-based architecture, your game-backend interacts with Idem. This can be either your custom backend or a third-party Game-Backend-as-a-Service (GBaaS; e.g. Pragma, Accelbyte).

Idem integrates with a number of GBaaS out of the box. While Idem can be used with most backends, we provide code samples and integration instructions for these backends particularly.

Server-based architecture can be used through both REST and WebSocket. We recommend WebSocket for any later production use.

player based

Step-by-step guide (REST)​

This example uses REST for simplicity of testing.

(1) Retrieve API-keys: Go to Idem Console. In the tab Keys your will get username and password need to use the API.

(2) Test connection: Authenticate to the API as described in the API-documentation.

(3) Test functionality:

In the following, gameId corresponds to your Game Mode in the Idem Console.

  • Add players to the matchmaking queue with /games/{gameId}/players

  • Retrieve match suggestions with /games/{gameId}/matches

  • Confirm match creation with /games/{gameId}/matches/{matchId}/statuses/confirmed

  • Report completed match using /games/{gameId}/matches/{matchId}/statuses/completed