Docs

Replace the platform origin and YOUR_BOARD_ID with the generated configuration, then connect the calls to actual round-start and game-over events.

const platform = 'https://www.ai-made.games';
const boardId = 'YOUR_BOARD_ID';

function getPlayerSession() {
  return new Promise((resolve, reject) => {
    const requestId = crypto.randomUUID();
    const finish = (error, session) => {
      clearTimeout(timer);
      window.removeEventListener('message', receive);
      error ? reject(error) : resolve(session);
    };
    const receive = (event) => {
      const data = event.data;
      if (event.source !== window.parent || event.origin !== platform ||
          !data || data.source !== 'aimadegames-platform' ||
          data.type !== 'leaderboard-session' || data.requestId !== requestId) return;
      if (data.error) return finish(new Error(data.error));
      if (data.apiOrigin !== platform || !data.session?.token) return;
      finish(null, data.session);
    };
    const timer = setTimeout(() => finish(new Error('Session timeout')), 15000);
    window.addEventListener('message', receive);
    window.parent.postMessage({source:'aimadegames', type:'leaderboard-session', requestId}, platform);
  });
}

async function request(path, token, body, key) {
  const response = await fetch(platform + '/api/v1/' + path, {
    method: key ? 'POST' : 'GET', credentials: 'omit',
    headers: {Authorization: 'Bearer ' + token,
      ...(key ? {'Idempotency-Key': key} : {}),
      ...(body ? {'Content-Type': 'application/json'} : {})},
    body: body ? JSON.stringify(body) : undefined,
    signal: AbortSignal.timeout(15000)
  });
  const data = await response.json();
  if (!response.ok) throw Object.assign(new Error(data.error?.message), {
    code: data.error?.code, retryAfter: response.headers.get('Retry-After')
  });
  return data;
}

// Save these per round. Reuse the same keys when retrying that round.
const startKey = crypto.randomUUID();
const scoreKey = crypto.randomUUID();
const session = await getPlayerSession();
const run = await request('leaderboards/' + boardId + '/runs', session.token, null, startKey);

// At final game-over, use the actual integer score from your game:
async function submitFinalScore(score) {
  // Refreshing the token preserves this player's run.
  const current = Date.parse(session.expiresAt) <= Date.now() + 60000
    ? await getPlayerSession() : session;
  return request('runs/' + run.runId + '/score', current.token, {score}, scoreKey);
}
// Catch failures in your game's event handlers so gameplay can continue.
// Retry settlement with the SAME run, scoreKey and final score.
// For a new round create new keys and call the start endpoint again.