Перейти к содержимому

Авторизация пользователя ​

Клиент передаёт серверу исходную строку initData. Сервер проверяет подпись токеном бота, проверяет возраст данных и читает ID пользователя из подтверждённого результата. Используйте этот ID для создания серверной сессии. Правила валидации MAX

Отправка данных из клиента ​

Установите @mwa.js/sdk и вызовите init() при монтировании приложения. Пример отправляет исходную строку как text/plain на серверный маршрут того же origin.

ts
import { launchParams } from '@mwa.js/sdk';

export async function requestUserId(): Promise<string> {
  const raw = launchParams()?.initData;
  if (!raw) throw new Error('Данные запуска MAX недоступны.');

  const response = await fetch('/api/validate', {
    method: 'POST',
    headers: { 'content-type': 'text/plain;charset=UTF-8' },
    body: raw,
  });
  if (!response.ok) throw new Error('Сервер не подтвердил данные запуска.');

  const { userId } = await response.json() as { userId: string };
  return userId;
}

Запускаемый пример на Node.js ​

В отдельном каталоге с Node.js 24 создайте проект и установите серверный пакет.

sh
npm init -y
npm pkg set type=module
npm install @mwa.js/init-data

Сохраните первый фрагмент в authorization-server.ts, второй — в server.ts. Сервер принимает POST /api/validate и возвращает подтверждённый ID пользователя строкой.

ts
import { createServer, type IncomingMessage, type ServerResponse } from 'node:http';

import { safeValidate } from '@mwa.js/init-data';

const MAX_BODY_BYTES = 64 * 1024;

function json(response: ServerResponse, status: number, body: object) {
  response.writeHead(status, {
    'content-type': 'application/json; charset=utf-8',
    'cache-control': 'no-store',
  });
  response.end(JSON.stringify(body));
}

async function readBody(request: IncomingMessage): Promise<Buffer | undefined> {
  let bytes = 0;
  const chunks: Buffer[] = [];
  for await (const chunk of request.iterator({ destroyOnReturn: false }) as AsyncIterable<Buffer>) {
    bytes += chunk.length;
    if (bytes > MAX_BODY_BYTES) {
      request.resume();
      return undefined;
    }
    chunks.push(chunk);
  }
  return Buffer.concat(chunks, bytes);
}

export function createValidationServer(botToken: string) {
  if (!botToken.trim()) throw new Error('Set MAX_BOT_TOKEN before starting the server.');

  async function handle(request: IncomingMessage, response: ServerResponse) {
    if (request.url !== '/api/validate') {
      request.resume();
      return json(response, 404, { error: 'not_found' });
    }
    if (request.method !== 'POST') {
      request.resume();
      response.setHeader('allow', 'POST');
      return json(response, 405, { error: 'method_not_allowed' });
    }
    const contentType = request.headers['content-type']?.split(';', 1)[0]?.trim().toLowerCase();
    if (contentType !== 'text/plain') {
      request.resume();
      return json(response, 415, { error: 'unsupported_media_type' });
    }

    const body = await readBody(request);
    if (!body) return json(response, 413, { error: 'body_too_large' });

    let raw: string;
    try {
      raw = new TextDecoder('utf-8', { fatal: true }).decode(body);
    } catch {
      return json(response, 400, { error: 'invalid_encoding' });
    }
    const result = await safeValidate(raw, botToken);
    if (!result.ok || !result.data.user) {
      return json(response, 401, { error: 'invalid_init_data' });
    }
    json(response, 200, { userId: result.data.user.id });
  }

  return createServer((request, response) => {
    void handle(request, response).catch(() => {
      if (!response.headersSent && !response.destroyed) {
        json(response, 500, { error: 'internal_error' });
      }
    });
  });
}
ts
import { createValidationServer } from './authorization-server.ts';

const server = createValidationServer(process.env.MAX_BOT_TOKEN ?? '');
server.listen(3001, '127.0.0.1', () => {
  console.log('Listening on http://127.0.0.1:3001/api/validate');
});

Проверка запроса ​

Запустите сервер с тестовым токеном.

powershell
$env:MAX_BOT_TOKEN = 'fixture-token'
node server.ts
bash
MAX_BOT_TOKEN=fixture-token node server.ts

Сохраните тестовый запрос в test-authorization.ts и запустите node test-authorization.ts в другом терминале. Скрипт подписывает свежие тестовые данные. Ожидаемый вывод — {"userId":"9223372036854775807"}.

ts
import { createHmac } from 'node:crypto';

const userId = '9223372036854775807';
const params: [string, string][] = [
  ['auth_date', String(Math.floor(Date.now() / 1000))],
  ['user', '{"id":' + userId + ',"first_name":"SDK Test"}'],
];
const launchParams = params.map(([key, value]) => key + '=' + value).sort().join('\n');
const secret = createHmac('sha256', 'WebAppData').update('fixture-token').digest();
const hash = createHmac('sha256', secret).update(launchParams).digest('hex');
const raw = [...params, ['hash', hash] as const]
  .map(([key, value]) => key + '=' + encodeURIComponent(value)).join('&');

const response = await fetch('http://127.0.0.1:3001/api/validate', {
  method: 'POST',
  headers: { 'content-type': 'text/plain;charset=UTF-8' },
  body: raw,
});
if (!response.ok) throw new Error('Проверка не прошла, HTTP ' + response.status);

const data: unknown = await response.json();
if (!data || typeof data !== 'object' || !('userId' in data) || data.userId !== userId) {
  throw new Error('Сервер вернул неожиданный идентификатор.');
}
console.log(JSON.stringify(data));

Запуск с ботом MAX ​

Задайте настоящий токен через MAX_BOT_TOKEN на сервере. Направьте HTTPS-маршрут /api/validate со стороны приложения на этот обработчик. На клиенте вызовите requestUserId() после инициализации SDK. Справочник валидации