API для серверов

Добавьте сервер в разделе Серверы и дождитесь одобрения. Затем нажмите «Создать ключ». Ключ показывается один раз — храните его в безопасности (формат cmc_…). Ключ нельзя восстановить, только перевыпустить.

Когда матч завершён, отправьте POST-запрос на эндпоинт:

POST https://competitiveminecraft.com/api/match/result
Content-Type: application/json
X-Server-Key: cmc_ваш_ключ

Тело запроса:

{
  "matchId": "<public_id матча>",
  "winnerUuid": "<UUID победителя без дефисов>",
  "timestamp": 1735000000,
  "signature": "<HMAC-SHA256 подпись>"
}

Чтобы исключить подделку результатов, каждый запрос подписывается вашим API-ключом. Подпись считается так:

message   = matchId + "." + winnerUuid + "." + timestamp
signature = HMAC_SHA256(apiKey, message)  // hex

timestamp — текущее unix-время (секунды). Запрос принимается только если время совпадает в пределах окна (по умолчанию ±30 секунд) — это защита от повторной отправки. Идентификатор матча (public_id) виден игрокам в URL страницы матча и передаётся плагину при старте игры.

String msg = matchId + "." + winnerUuid + "." + timestamp;
Mac mac = Mac.getInstance("HmacSHA256");
mac.init(new SecretKeySpec(apiKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256"));
byte[] raw = mac.doFinal(msg.getBytes(StandardCharsets.UTF_8));
String signature = HexFormat.of().formatHex(raw);

curl -X POST https://competitiveminecraft.com/api/match/result \
  -H "Content-Type: application/json" \
  -H "X-Server-Key: cmc_xxx" \
  -d '{"matchId":"abc123","winnerUuid":"06ec...","timestamp":1735000000,"signature":"a1b2..."}'