Раскидки Warface
в вашем приложении

Пример подключения

Браузер обращается к вашему backend, а backend — к Warface Lineups. CORS для прямого подключения стороннего браузера не включён. Не передавайте токен в query string, localStorage, NEXT_PUBLIC-переменные, клиентский JavaScript или embed-код.

// Backend only. Save as an ES module (.mjs); requires Node.js 22+.
// Keep WARFACE_LINEUPS_TOKEN in private server configuration.
const tokenName = 'WARFACE_LINEUPS_TOKEN';
const token = process.env[tokenName];
if (!token) throw new Error('Missing API token');
const base = "https://warfacelineups.ru/api/v1";

async function api(path) {
  const response = await fetch(base + path, {
    headers: {Authorization: 'Bearer ' + token},
    signal: AbortSignal.timeout(8000), cache: 'no-store',
  });
  if (!response.ok) {
    const error = new Error('Lineups API HTTP ' + response.status);
    error.status = response.status;
    error.retryAfter = response.headers.get('Retry-After');
    throw error; // Honor Retry-After on 429; never log headers.
  }
  return response.json();
}

export async function getMapLineupBatch(mapReference, page = 1) {
  if (typeof mapReference !== 'string' || !mapReference.trim() || mapReference.length > 100) {
    throw new Error('Invalid map reference');
  }
  if (!Number.isInteger(page) || page < 1 || page > 1000) {
    throw new Error('Invalid continuation page');
  }
  const {data: map} = await api('/maps/' + encodeURIComponent(mapReference));
  if (!map || typeof map.id !== 'string') throw new Error('Invalid map response');
  const byId = new Map();
  const stopPage = Math.min(1000, page + 4); // At most five pages per batch.
  for (; page <= stopPage; page++) {
    const result = await api('/maps/' + encodeURIComponent(map.id) +
      '/lineups?pageSize=100&page=' + page);
    if (!Array.isArray(result.data) || result.pagination?.page !== page ||
        typeof result.pagination?.hasNextPage !== 'boolean') {
      throw new Error('Invalid lineup response');
    }
    for (const item of result.data) byId.set(item.id, item);
    if (!result.pagination.hasNextPage) {
      return {map, lineups: [...byId.values()], complete: true,
        nextPage: null, paginationLimitReached: false};
    }
  }
  return {map, lineups: [...byId.values()], complete: false,
    nextPage: stopPage < 1000 ? stopPage + 1 : null,
    paginationLimitReached: stopPage === 1000};
}

// Start with the stable map id selected from GET /maps.
// Continue with getMapLineupBatch(mapId, previous.nextPage).
// Merge batches by lineup.id. Send public data, never the token, to the browser.

Сохраните код выше в lineups-api.mjs на своём сервере с Node.js 22+ и задайте закрытую переменную WARFACE_LINEUPS_TOKEN. Затем сохраните следующий код рядом в read-lineups.mjs и запустите его, передав реальный id из /maps вместо MAP_ID_FROM_CATALOGUE. Результат — JSON, а не готовая веб-страница.

// Save as read-lineups.mjs beside lineups-api.mjs.
const modulePath = './lineups-api.mjs';
const {getMapLineupBatch} = await import(modulePath);

const mapId = process.argv[2]; // Full id returned by GET /maps.
const page = Number(process.argv[3] ?? '1');
if (!mapId) throw new Error('Pass a catalogue map id as the first argument');
const batch = await getMapLineupBatch(mapId, page);
console.log(JSON.stringify(batch, null, 2)); // Public data only, no token.

// Run: node read-lineups.mjs MAP_ID_FROM_CATALOGUE
// If nextPage is not null: run again with that page as the second argument.
// In a web app, return batch as JSON from your own backend route instead.
// The frontend reads map.scheme and lineups; it never receives token headers.

Передайте найденный id карты в getMapLineupBatch. Один вызов загружает до 5 страниц по 100 раскидок и схему. complete = false означает, что данные ещё неполные: продолжите с nextPage, объединяя результаты по id и соблюдая лимит запросов. complete = true завершает обход. Если paginationLimitReached = true, достигнута страница 1000: сохраните данные, обозначьте неполноту и сузьте фильтры для дальнейшего поиска. Исключение не превращается в пустой каталог; пример не делает автоматических повторов. Для проверки всей формы ответа используйте OpenAPI.

В веб-приложении вызовите эту функцию из своего серверного обработчика и верните браузеру только map, lineups и состояние продолжения. На клиенте отрисуйте scheme.imageUrl, отметьте доступные точки и используйте ссылки media для просмотра. Токен и заголовок Authorization остаются на вашем backend. Храните nextPage на своей стороне между пакетами; API не создаёт отдельную сессию обхода.

Объединяйте одновременные запросы одной карты и задайте короткий срок локального кеша, например 60 секунд. Он определяет давность данных в вашем приложении, а не гарантирует публикацию навсегда. При 404 удаляйте материал из текущей выдачи; при временном сбое оставляйте последние данные с понятным состоянием. Медиа загружайте по мере просмотра. Ссылку «Открыть в Warface Lineups» берите из canonicalUrl.

Лимиты, ошибки и безопасность

120 запросов на токен за фиксированную календарную минуту, включая запросы, которые закончились ошибкой после авторизации. На границе минуты начинается новое окно. X-RateLimit-Limit сообщает лимит, на 429 Retry-After задаёт ожидание в секундах. Ответы API имеют Cache-Control: private, no-store: не помещайте их вместе с Authorization в публичный CDN-кеш.

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "A valid Bearer token is required."
  }
}

400

Некорректные или неподдерживаемые параметры запроса. Исправьте запрос по справочнику. Повтор без изменений не поможет.

401

Токен отсутствует, недействителен, отозван или истёк. Проверьте заголовок Bearer и состояние токена в настройках.

404

Карта, тип гранаты или опубликованная раскидка не найдены. Обновите справочники. Снятый с публикации материал может исчезнуть.

429

Лимит запросов исчерпан. Дождитесь Retry-After; объединяйте одинаковые запросы на своём сервере.

503

API временно недоступен. Сохраните полезные последние данные с отметкой об их давности; повторите позже с ограниченным backoff.

До 5 активных токенов на аккаунт. Срок каждого — 365 дней; до 10 попыток создания за час. Полный ключ показывается один раз. Потерянный ключ отзовите и создайте новый. Отзыв, смена или сброс пароля и завершение других сеансов аккаунта прекращают действие ранее созданных токенов. Токен предоставляет только чтение публичного каталога и не даёт доступ к профилю, модерации или неопубликованным материалам.

При обработке ошибок ориентируйтесь на HTTP status и error.code; текст message предназначен для пояснения и может меняться. Даты createdAt и updatedAt — ISO 8601 в UTC. Не считайте число раскидок постоянным и сохраняйте совместимость с новыми полями ответа. Несовместимые изменения получат новую версию API.