TGAPI
SESSION RELAY CONSOLE

让每一条验证码，
清晰抵达。

集中管理 Telegram 会话、接码链接与运行状态，为自动化流程提供稳定可靠的验证码中继。

  • 实时状态账号在线与异常一目了然
  • 会话安全HttpOnly Cookie 与 CSRF 双重防护
  • 即接即用文本、JSON 与长轮询接口
TGAPI · Telegram Session Relay
管理员访问

欢迎回来

登录以进入会话管理控制台

管理员初始化异常？请检查服务器凭据目录权限，或在项目目录运行以下恢复命令；自定义配置请在 admin-setup 前添加 --config 配置路径。完成后重启服务。python -m tgapi admin-setup --reset
密码与管理 key 不会保存在浏览器中。会话到期后需要重新登录。
TGAPISESSION RELAY
工作台
安全会话已启用凭据仅保留在当前会话
键盘快捷键
Ctrl K搜索账号
R立即刷新
TGAPI Console · v4
TGAPI
工作区默认工作区
连接中
管理员
ACCOUNT POOL

账号管理

管理 Telegram 登录会话，查看连接状态与最新验证码。

账号总数
—
等待加载
在线会话
—
正常提供服务
需要关注
—
离线或异常会话
捕获验证码
—
累计捕获

会话列表

点击验证码即可复制，更多操作位于每行末尾。

⌘ K
账号连接状态最近验证码快捷入口操作
已选 0 项
—每 8 秒自动刷新
DEVELOPER API

接码接口

将验证码能力接入发卡平台、注册机或自己的自动化脚本。

REST API

公开接口

使用账号 UUID 与账号级 API Key 访问，支持纯文本和 JSON。

GET
/getcode?id=<uuid>获取最新验证码 · 纯文本
GET
/getcode?id=<uuid>&json=1获取结构化验证码数据
GET
/getcode?id=<uuid>&wait=60&after=<id>&json=1长轮询等待下一条新验证码
GET
/<uuid>/GetHTML打开自动刷新的网页接码页面

快速调用

已自动填入当前域名与首个账号 UUID。

Shell

              

            

            

              
调用前准备
两步完成接口接入

              

                
1
获取账号 UUID
在账号列表中找到目标会话，复制其接码链接即可获取 UUID。

                
2
携带 API Key
脚本调用建议使用 Authorization: Bearer 请求头，按账号独立保管。

                
需要持续等待新验证码时，推荐使用 wait=60 与 after 参数，避免重复读取。

              

            

          

          

            
管理接口
仅供控制台使用 · HttpOnly Cookie + X-CSRF-Token

            

              
GET/api/accounts账号列表与统计

              
GET/api/auth/session检查管理会话

              
GET/api/auth/csrf获取 CSRF 凭据

              
POST/api/import导入单个 session

              
POST/api/upload上传 session / tdata.zip

              
POST/api/import_bulk批量导入账号

              
POST/api/login/start手机号登录：发送验证码

              
POST/api/login/complete提交验证码 / 2FA

              
POST/api/accounts/{id}/reconnect重新连接

              
POST/api/accounts/{id}/kill注销设备

              
POST/api/accounts/{id}/delete注销并删除

            

          

        


        

          
ACTIVITY
操作日志
查看当前浏览器中的最近 50 条管理操作，仅保存在本次会话。

          
最近活动
导入、重连、注销与账号安全操作会记录在这里。

        

      

    

  


  

    
    
    
  







  

    
添加账号
通过手机号登录，或导入已有会话

    

      

        
        
        
      

      

        
使用 Telegram 账号登录验证码会发送到已登录设备或短信，登录事务 5 分钟后失效。

        
请包含国家代码

        

        

      

      

        
拖入文件到这里，或点击选择
支持 .session、tdata.zip 和 session.txt

        
        

        
文件仅用于当前导入，不会在浏览器中保留。

      

      

        
单行走单个导入；多行按「手机号 | session」批量导入，手机号可省略。

      

      
高级选项API 凭据、手机号与代理

      

    

    
敏感信息仅用于本次操作

  







  

    
设置 2FA 密码
加密保存在本机数据库

    
Telegram 两步验证已保存的密码不会回显，管理接口只返回设置状态。
留空并保存等于清除

    

  







  

    
账号安全
修改控制台登录账号，不影响 Telegram 两步验证。

    

      
初始账号仅能完成此设置或退出登录，不能查看或管理 Telegram 账号。新的用户名不能继续使用 admin。

      
3–64 位字母、数字、点、下划线或短横线

      

      
设置新密码

      
10–128 个字符，推荐使用长口令

      

      

    

    

  







  

    
确认操作