Telegram 小程序 | TypeScript @telegram-apps/sdk @1.x | 初始数据

riyad

初始数据​

SDK 的这一部分提供了使用 Mini Apps init data 的实用程序。

解析​

该库包含函数 parseInitData，可从查询参数中提取初始化数据 信息。 下面是一个使用示例：

1. import { parseInitData } from '@telegram-apps/sdk';
   
2. 
   
3. // Let's imagine, we have init data in a raw format like this. Telegram application is
   " J. O* u9 ~7 L8 c6 z- v
4. // sending it in the exact same format.
   ) S- C# J$ I" G& Z8 m4 W9 s4 V0 r& w
5. const initDataString =
   0 W5 a. R' C+ d% q* Q: Z
6.   'query_id=AAHdF6IQAAAAAN0XohDhrOrc' +
   
7.   '&user=%7B%22id%22%3A279058397%2C%22first_name%22%3A%22Vladislav%22%2C%22last_name%22%3A%22Kibenko%22%2C%22username%22%3A%22vdkfrost%22%2C%22language_code%22%3A%22ru%22%2C%22is_premium%22%3Atrue%7D' +
   
8.   '&auth_date=1662771648' +
   
9.   '&hash=c501b71e775f74ce10e377dea85a7ea24ecd640b223ea86dfe453e0eaed2e2b2';
   
10. 
    6 J) M: a# P/ ~7 u/ l( r
11. // Extract init data.
    
12. console.log(parseInitData(initDataString));
    8 g+ y3 ^3 {' ~$ J5 W6 E9 \
13. // or
    
14. console.log(parseInitData(new URLSearchParams(initDataString)));
    ; q" |% E1 c% }. O- C& n
15. 
    % k/ \0 U6 P% e3 X, x/ \) T) }/ ]
16. // Output:
    6 {+ K# [& Y7 }6 a2 U4 Y: k9 d
17. // {
    * K& X! `$ t0 \. h+ X4 h5 ^
18. //   authDate: 2022-09-10T01:00:48.000Z,
    3 t" u$ B: l9 ]
19. //   hash: 'c501b71e775f74ce10e377dea85a7ea24ecd640b223ea86dfe453e0eaed2e2b2',
    
20. //   queryId: 'AAHdF6IQAAAAAN0XohDhrOrc',
    9 T8 Y! l' e% t3 X" i- \0 k1 j
21. //   user: {
    8 B" O. k* `- N% x$ U
22. //     id: 279058397,
    
23. //     firstName: 'Vladislav',
    ! r; x$ q/ X) o9 C0 t
24. //     lastName: 'Kibenko',
    
25. //     username: 'vdkfrost',
    & N/ E, X1 m4 w+ D5 @
26. //     languageCode: 'ru',
    $ d& F- e5 M) h3 s, M
27. //     isPremium: true
    
28. //   }
    
29. // }

复制代码

该函数提取所需的参数，并自动验证其类型。 如果 中的属性类型或值无效，则会出错。 要了解返回类型的更多信息，请参阅 的 InitData 类型页面。
, M- H4 l* G# Y, _+ J0 Y; h
验证和签名​

验证和签名实用程序已移至独立的 软件包 - @telegram-apps/init-data-node 中。