Launcher endpoints

Production base URL: https://wraithbound.com/api/. Development base URL: http://127.0.0.1:3000/api/.

Авторизация и оборудование

Метод	Путь	Назначение
POST	`launcher/oauth/configuration`	Публичная конфигурация device flow
POST	`launcher/oauth/device/register`	Регистрация hardware fingerprint
POST	`launcher/oauth/device/connect`	Связь HWID с авторизованным пользователем
POST	`launcher/oauth/device/code`	Создание device code
POST	`launcher/oauth/token`	Polling статуса и получение токена
POST	`launcher/oauth/userinfo`	Профиль по Bearer token
POST	`launcher/oauth/revoke`	Отзыв launcher-сессии

Получение профиля запуска

POST /api/launcher/builds/profile
Authorization: Bearer <access-token>
Content-Type: application/json

{ "server_id": 12 }

Успешный ответ содержит профиль Minecraft, descriptor сборки и descriptor Java runtime:

{
  "profile": {
    "title": "Create",
    "recommendJavaVersion": 21,
    "mainClass": "net.minecraft.client.main.Main"
  },
  "build": {
    "serverId": 12,
    "revision": "f2e64f3b0215d7d5f24c8f8d",
    "delivery": "signed",
    "managed": ["libraries", "mods", "natives", "minecraft.jar"],
    "preserve": ["logs", "screenshots", "saves", "options.txt"],
    "forceDownload": [],
    "manifest": {}
  },
  "runtime": {
    "id": "java-21-win32-x64",
    "version": 21,
    "platform": "win32",
    "arch": "x64",
    "revision": "a-runtime-revision",
    "delivery": "signed",
    "executable": "bin/javaw.exe",
    "consoleExecutable": "bin/java.exe",
    "manifest": {}
  }
}

Возможные ошибки:

Ошибка	Причина
`invalid_token`	Bearer token отсутствует, истёк или отозван
`invalid_request`	`server_id` не является положительным integer
`BUILD_PROFILE_NOT_FOUND`	Сервер отсутствует/скрыт или metadata не опубликованы
`INVALID_BUILD_PROFILE_*`	Поле profile.json не прошло строгую проверку
`INVALID_BUILD_MANIFEST`	Некорректная схема manifest
`JAVA_RUNTIME_EXECUTABLE_MISSING`	В runtime manifest нет java.exe/javaw.exe
`JAVA_RUNTIME_VERSION_MISMATCH`	`manifest.version` не совпадает с рекомендуемой Java
`INVALID_JAVA_RUNTIME_VERSION`	Неподдерживаемое значение версии

Signed URL файлов клиента

POST /api/launcher/builds/resolve
Authorization: Bearer <access-token>
Content-Type: application/json

{
  "server_id": 12,
  "paths": ["libraries/example.jar", "mods/example.jar"]
}

Ответ:

{
  "files": [
    {
      "path": "libraries/example.jar",
      "url": "https://s3.example/signed-url"
    }
  ]
}

Путь разрешается только если он присутствует в отфильтрованном manifest активного профиля.

Signed URL Java runtime

POST /api/launcher/builds/runtime/resolve
Authorization: Bearer <access-token>
Content-Type: application/json

{
  "runtime_id": "java-21-win32-x64",
  "paths": ["bin/javaw.exe", "lib/modules"]
}

runtime_id должен соответствовать формату java-{8..999}-win32-x64. Backend заново получает manifest выбранной версии и не доверяет списку путей из запроса.

Ограничения download resolution

endpoint’ы требуют активную launcher OAuth session;
один запрос содержит от 1 до 500 уникальных путей;
каждый путь должен быть безопасным относительным POSIX-путём;
URL действует 15 минут;
клиент должен проверить SHA-256 после загрузки, signed URL сам по себе не заменяет проверку целостности.

Не добавляйте S3 credentials или PRODUCTION_CONFIG_ENCRYPTION_KEY в ответы API. Лаунчеру нужны только metadata и временные URL.

Устройство

Launcher API

Production

Авторизация и оборудование

Получение профиля запуска

Signed URL файлов клиента

Signed URL Java runtime

Ограничения download resolution

​Авторизация и оборудование

​Получение профиля запуска

​Signed URL файлов клиента

​Signed URL Java runtime

​Ограничения download resolution

Авторизация и оборудование

Получение профиля запуска

Signed URL файлов клиента

Signed URL Java runtime

Ограничения download resolution