Telegram 小程序 | GoLang init-data-golang

riyad

该软件包提供用于处理 Telegram 迷你应用程序初始化数据的实用程序。 要了解 有关初始化数据及其用法的更多信息，请参阅 文档.
* Q8 \1 _$ V. Y/ h! j, |& P4 y
安装

1. go get github.com/telegram-mini-apps/init-data-golang

复制代码

验证​

如果过期时间设置为 0，函数将跳过过期时间检查。 不过，建议指定一个非零值，因为这一检查对于防止 使用被盗的旧初始化数据非常重要。

1. package main
   
2. 
   
3. import (
   
4.         "fmt"
   
5.         "github.com/Telegram-Mini-Apps/init-data-golang"
   6 Q  G0 z3 b5 n& ^- }, a
6.         "time"
   % ~/ a) N( e! Y- B8 f) ^
7. )
   
8. 
   
9. func main() {
   - f, M7 w( ]+ W0 w% B9 n
10.         // Init data in raw format.
    ) }) v5 y5 N3 V" ~, B& k2 w
11.         initData := "query_id=AAHdF6IQAAAAAN0XohDhrOrc&..."
    6 |5 q/ a1 U/ t
12. 
    
13.         // Telegram Bot secret key.
    
14.         token := "627618978:amnnncjocxKJf"
    
15. 
    ( a/ l, x& N) f6 o" K5 t  }
16.         // Define how long since init data generation date init data is valid.
    0 i6 A) o+ h* w  j0 v% \
17.         expIn := 24 * time.Hour
    
18. 
    5 i. a) q7 ?. J' d
19.         // Will return error in case, init data is invalid. To see,
    " }) G8 D9 A0 r$ B7 I0 ]/ ?- A
20.         // which error could be returned, see errors.go file.
    
21.         fmt.Println(initdata.Validate(initData, token, expIn))
    
22. }

复制代码

解析​

需要注意的是，Parse 函数不会执行与 Validate 函数相同的检查。 因此，该函数只对输入数据进行解析，而不对 哈希值或过期时间进行验证。

1. package main
   
2. 
   & N$ B! ?( N0 u
3. import (
   ; L) W7 J1 P8 `1 y- A* R( Q7 |
4.     "fmt"
   " e# Q- ~8 \! G- P! ~  k3 o
5.     "github.com/Telegram-Mini-Apps/init-data-golang"
   * g! Y, d0 N0 m  n' Q
6. )
   % Z: L' Z  Z9 X# C. H
7. 
     Z: ]- |0 _) y
8. func main() {
   
9.         // Init data in raw format.
   , C. t, N2 c0 {4 D( _' B
10.         initData := "query_id=AAHdF6IQAAAAAN0XohDhrOrc&..."
    
11.        
    " O! z  z, R7 n. E9 Z3 ~
12.         // Will return 2 values.
    - @2 w, i6 K2 M* f0 F1 z  X- z$ n( z
13.         // 1. Pointer to InitData in case, passed data has correct format.
    * X% T' J  Q$ Z7 U9 a" E
14.         // 2. Error in case, something is wrong.
    1 i; l/ \' K$ b. N* F* x( T
15.         fmt.Println(initdata.Parse(initData))
    
16. }

复制代码

签名​

签署数据的函数会删除hash和auth_date等参数，因为假定 ，hash将由函数返回，auth_date将由函数 本身设置。

1. package main
   5 O; k: h3 @/ ~5 _8 `! ?" i% |( U
2. 
   
3. import (
   
4.         "fmt"
   " h$ ?" ?3 t3 O$ ?
5.         "github.com/Telegram-Mini-Apps/init-data-golang"
   
6.         "time"
   
7. )
   # H8 x; R. O. m
8. 
   # d1 {6 o2 O- E
9. func main() {
   
10.         // Init data in raw format.
    , V2 w7 g0 v* y+ `5 ?; q# Q
11.         initData := "query_id=AAHdF6IQAAAAAN0XohDhrOrc&..."
    
12. 
    
13.         // Telegram Bot secret key.
    
14.         token := "627618978:amnnncjocxKJf"
    
15. 
    " M$ c( ~. q4 b& ^7 C& \
16.         // Signing timestamp.
    . j1 h3 n; a% Z3 e0 D& ?
17.         authDate := time.Now()
    7 r) O8 d. j; o
18. 
    , V+ N, d4 z* D( x2 c' s$ w/ C
19.         // The first value is parameters sign result ("hash" init data property).
    
20.         // The second one is error which could occur while parsing query string as
    " ?3 T. p- b) Y, R$ X8 y0 l% H1 o
21.         // query parameters.
    
22.         fmt.Println(initdata.SignQueryString(initData, token, authDate))
    
23.         // or
    
24.         fmt.Println(initdata.Sign(map[string]string{
    
25.                 "query_id": "AAHdF6IQAAAAAN0XohDhrOrc",
    2 w4 y7 ?: q9 m" H
26.                 // ...
    " }: \. x5 y% m$ P& v. P
27.         }, token, authDate))
    0 B' ^$ k% F( M9 j2 p( H) H+ ~
28. }

复制代码

GoDoc​

要查看 GoDoc 文档，请访问 此链接。

( H( h3 M% G6 G2 |7 b& G7 ]