想在几分钟内连接 TON 区块链并调用数据、发送交易乃至部署智能合约?本指南手把手演示如何通过 GetBlock 提供的 TON RPC API 完成全部流程——从创建账户、生成专属端点到调整并发、规避限速,覆盖免费方案与专用节点差异,让你真正“即连即用”。
快速预览:三招跑通“Hello TON”
- 注册账户即可拿到 40,000 次免费请求,无门槛体验 TON JSON-RPC。
- 生成端点 URL 后,一条
curl就能查余额、查状态、查 NFT;10 分钟写好脚本。 - 对高并发或生产需求,30 秒无缝升级 共享节点 或 专用节点,不中断原程序。
关键词聚焦
GetBlock|TON API|TON 区块链|RPC 端点|免费节点|共享节点|专用节点|TON 开发者|区块链交互|智能合约部署
01 创建专属 TON 端点的三步曲
1.1 注册账户
访问官网首页,点击「免费开始」。你可以:
- 邮箱一键注册;
- 或通过钱包(MetaMask、TON Wallet 均可)直接登录。
新用户自动获赠 40,000 免费请求,日更 60 RPS 流量,足够中小项目验证 MVP。
1.2 选定链与接口
登录后进入「My Endpoints」:
- Protocols ➜ 选择 TON
- API 类型 ➜ 选 JSON-RPC(v1 稳定) 或 JSON-RPC v2(功能全)
1.3 生成 URL
点击「Get」按钮即可获得:
https://go.getblock.io/<ACCESS-TOKEN>/该一级 ACCESS-TOKEN 就是你的身份凭证,不再需要额外 header。官方支持:
- 随时 旋转(rotate)令牌 以保护密钥;
- 删除未使用端点,节省费用;
- 可以配置 多环境 多条 URL。
02 免费、共享、专用节点横向对比
| 场景需求 | 免费套餐 | 共享节点 | 专用节点 |
|---|---|---|---|
| 每日免费请求 | 40,000 | 无上限 | 无上限 |
| 峰值 RPS | 60 | 200 | 自由带宽 |
| 节点独占性 | 共享 | 共享 | 独享 |
| 存档数据 | × | √ | √ |
| 自定义配置 | × | 部分 | 完全 |
| 价格 | ¥0 | <一杯咖啡/月 | 企业报价 |
- 个人开发者先用 免费节点 写原型;
- 业务量级成长再升级到 共享节点;
- 如果对延迟或并发有 SLA 要求,直接跳 专用节点。
03 实战:三条核心 API 调用范例
3.1 查询账户余额
curl -X GET "https://go.getblock.io/<ACCESS-TOKEN>/getAddressBalance?address=EQDXZ2c5LnA12Eum-DlguTmfYkMOvNeFCh4rBD0tgmwjcFI-" \
-H "Content-Type: application/json"返回将以 nanotons(10⁻⁹ TON) 为单位。
3.2 查询地址状态
curl -X GET "https://go.getblock.io/<ACCESS-TOKEN>/getAddressState?address=... "结果:uninitialized|active|frozen,一秒识别账户是否激活。
3.3 发送原始 BOC 交易
curl -X POST "https://go.getblock.io/<ACCESS-TOKEN>/sendBoc" \
-H "Content-Type: application/json" \
-d '{"boc":"<base64-encoded-boc>"}'- sendBoc 可将离线签名的 BOC 直接上链;
- 配合 TON SDK(如 ton.js、tonweb)10 行代码即完成“链上写操作”。
04 持续深化:锁定高并发与高稳定
- 将
ACCESS-TOKEN存为环境变量,配合 CI/CD → 无痛封装测试网&主网两套配置。 - 共享/专用节点支持 WebSocket,适合订阅事件、监听新区块。
- 异步重试+幂等写操作,有效抵消 RPC 节点抖动。
05 部署 TON 智能合约的两种姿势
5.1 “一键脚本”法
使用 toncli 或 blueprint 框架,修改 client.json:
{
"endpoint": "https://go.getblock.io/<ACCESS-TOKEN>/"
}执行:
toncli deployGetBlock 自动完成网络同步,环境 0 等待。
5.2 “全链路 SDK”法
Python 工程师可直接用 pytonlib:
from pytonlib import TonlibClient
client = TonlibClient(config='https://go.getblock.io/<ACCESS-TOKEN>/')
await client.init()
await client.raw_send_message(message_boc=boce)全程不碰原生节点二进制,彻底分离运维与开发。
常见问题 FAQ
Q1:免费额度用完了怎么办?
A:系统每日 00:00 UTC 自动补满 40,000 次。若业务量大,可 一键升级共享节点,或联系销售开通 专用节点套餐。
Q2:跨网段生产环境如何保证稳定性?
A:对专线有 SLA 需求的团队,可申请 专用节点 + 私有网段 IP 或 负载均衡 方案,确保延迟 < 100 ms。
Q3:同一个 ACCESS-TOKEN 会被他人滥用吗?
A:令牌已与账户绑定+同 IP 策略,可在「Dashboard」一键撤销并重新生成;亦可配置仅特定 CIDR 才可调用。
Q4:能否同时连接测试网与主网?
A:支持。为每条链各建一个端点即可,互不冲突。
Q5:Data API 是否支持 NFT 元数据拉取?
A:支持。/getTokenData 与 /getNftItemByAddress 已上线实验版,保持兼容性后续再加字段。
快速上路清单
- [ ] 注册并保存官方给的 ACCESS-TOKEN
- [ ] 试用
getAddressBalance验证返回余额 - [ ] 把 URL 集成进本地脚本或 dApp
- [ ] 评估 60 RPS 是否够用,再在仪表盘升级套餐
- [ ] 准备远程 智能合约部署 测试
快把本指南加入浏览器书签,GetBlock TON API 让开发者把精力聚焦在产品逻辑,而不再是烦人的节点运维。下个爆款 DApp,就从今天这行 curl 开始!