Авторизация пользователя
Клиент передаёт серверу исходную строку initData. Сервер проверяет подпись токеном бота, проверяет возраст данных и читает ID пользователя из подтверждённого результата. Используйте этот ID для создания серверной сессии. Правила валидации MAX
Отправка данных из клиента
Установите @mwa.js/sdk и вызовите init() при монтировании приложения. Пример отправляет исходную строку как text/plain на серверный маршрут того же origin.
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 создайте проект и установите серверный пакет.
npm init -y
npm pkg set type=module
npm install @mwa.js/init-dataСохраните первый фрагмент в authorization-server.ts, второй — в server.ts. Сервер принимает POST /api/validate и возвращает подтверждённый ID пользователя строкой.
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' });
}
});
});
}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');
});Проверка запроса
Запустите сервер с тестовым токеном.
$env:MAX_BOT_TOKEN = 'fixture-token'
node server.tsMAX_BOT_TOKEN=fixture-token node server.tsСохраните тестовый запрос в test-authorization.ts и запустите node test-authorization.ts в другом терминале. Скрипт подписывает свежие тестовые данные. Ожидаемый вывод — {"userId":"9223372036854775807"}.
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. Справочник валидации