跳到主要内容

API 参考

HashNut 提供了一个全面的 RESTful API，用于在 164+ 区块链网络上接受加密货币支付。所有 API 端点都使用基于 HMAC-SHA256 签名的身份验证。

基础 URL​

  • 测试网: https://testnet.hashnut.io
  • 生产环境: https://api.hashnut.io (即将推出)

API 版本控制​

所有 v3.0.0 端点都以 /api/v3.0.0/ 为前缀

当前版本: v3.0.0

快速链接​

身份验证​

所有 API 请求都需要 HMAC-SHA256 签名身份验证。详情请参阅身份验证指南。

请求格式​

标头​

所有经过身份验证的请求必须包括:

hashnut-request-uuid: <unique-uuid>
hashnut-request-timestamp: <timestamp-in-milliseconds>
hashnut-request-sign: <hmac-sha256-signature-base64>
Content-Type: application/json

请求体​

所有请求体使用 JSON 格式:

{
  "accessKeyId": "string",
  "merchantOrderId": "string",
  "chainCode": "string",
  "coinCode": "string",
  "amount": 0.01
}

响应格式​

成功响应​

{
  "code": 0,
  "msg": "success",
  "data": {
    // Response data
  }
}

错误响应​

{
  "code": -2,
  "msg": "Invalid signature or credentials",
  "data": null
}

响应代码:

速率限制​

速率限制:

  • 标准层级:
  • 高交易量层级:
  • 企业层级:

速率限制标头包含在响应中:

  • X-RateLimit-Limit: 每个时段的最大请求数
  • X-RateLimit-Remaining: 当前时段剩余的请求数
  • X-RateLimit-Reset: 限制重置的时间

支持的链​

HashNut 支持 164+ 区块链网络。详情请参阅多链支持。

常见链代码:

  • erc20: Ethereum
  • polygon-erc20: Polygon
  • bsc-erc20: Binance Smart Chain
  • tron-trc20: TRON

SDK 支持​

官方 SDK 可用于:

快速开始​

  1. 获取 API 凭证: 创建账户并生成 API 密钥
  2. 验证请求: 学习签名生成
  3. 创建您的第一个订单: 创建支付订单
  4. 处理 Webhooks: 设置支付通知

支持​

API 支持和问题:

下一步​

准备集成？ 从 身份验证 → 开始