授权

获取 API 授权密钥

API 访问密钥可以在您的个人账户的 "API 密钥" 部分获取。

IP 地址访问限制

出于安全考虑,API 访问受 IP 地址限制。在个人账户中创建或编辑 API 密钥时,您必须指定允许的 IP 地址列表。

强制配置

API 密钥必须至少指定一个 IP 地址才能激活。仅允许公共 IP 地址 — 不允许使用私有地址和 localhost。

API 请求授权

通过在请求中发送以下标头来执行授权:

标头	值	格式	必需
`X-Processing-Key`	在个人账户中获取的公共 API 密钥	不带连字符和花括号的 GUID	必需
`X-Processing-Timestamp`	创建和发送请求时的时间戳(毫秒)	Unix 时间戳(毫秒)	必需
`X-Processing-RecvWindow`	时间戳之后请求有效的毫秒数	整数	可选(默认 5000 毫秒)
`X-Processing-Signature`	使用 HMAC-SHA512 密钥签名的请求数据	base64 编码值	必需

计算 X-Processing-Signature

算法

形成待签名数据,按以下顺序连接请求部分组成字符串:
1. X-Processing-Timestamp 标头的值 +
2. X-Processing-RecvWindow 标头的值(如果提供) +
3. 请求的 HTTP 方法类型(GET、POST 等) +
4. 请求的相对 URL(路径 + 查询参数) +
5. 请求正文(如果提供)
计算签名值,将请求数据作为字节序列:
- 算法:HMACSHA512
- 密钥:从 base64 编码的密钥值获取的密钥字节序列
- 待签名数据:UTF-8 编码的待签名字符串的字节序列
传递签名值,在 X-Processing-Signature 标头中使用 base64 编码

签名计算示例

API 密钥

密钥	值
apiPublicKey	`d93b40983c61423c9a84-9956bf1c3549`
apiSecretKey	`KTxbhABQWghHHkeOFUAUFIb8u9S2rr0nVklG7/x9EtXKdq9sELhhfYbdsTL1QGK5DWsjrxzTeAP2Zf/hrkv3ZK210fmU/ld30avXEzjHCeBoxYXPCjuTEWtkiFHEOfBczL85rFsLeu0fGZVFmOmnihnMTVbkjmgcSqfYWcpKKYE=`

请求

curl -X POST "https://api.crypto2b.com/v1/channels/take" \
  -H "Content-Type: application/json" \
  -H "X-Processing-Key: d93b40983c61423c9a849956bf1c3549" \
  -H "X-Processing-Signature: meQrmb8yTnQK3PJTxGakG71iUVpVxgxcj5B30H7XPhaoP0eiRV2JRBZbgk5vwiqUv5snGcKapousInHtn/Rodg==" \
  -H "X-Processing-Timestamp: 1499827320350" \
  -H "X-Processing-RecvWindow: 6000" \
  -d '{"currencyShortName":"USDT","transportProtocol":"trc20","foreignId":"user-007"}'

计算步骤

待签名字符串:

14998273203506000POST/v1/channels/take{"currencyShortName":"USDT","transportProtocol":"trc20","foreignId":"user-007"}

UTF-8 编码的待签名字符串的字节序列(HEX):

3134393938323733323033353036303030504f53542f76312f6368616e6e656c732f74616b657b2263757272656e637953686f72744e616d65223a2255534454222c227472616e73706f727450726f746f636f6c223a227472633230222c22666f726569676e4964223a22757365722d303037227d

apiSecretKey 的字节序列(HEX):

293c5b8400505a08471e478e1540141486fcbbd4b6aebd27564946effc7d12d5ca76af6c10b8617d86ddb132f54062b90d6b23af1cd37803f665ffe1ae4bf764adb5d1f994fe5777d1abd71338c709e068c585cf0a3b93116b648851c439f05cccbf39ac5b0b7aed1f19954598e9a78a19cc4d56e48e681c4aa7d859ca4a2981

X-Processing-Signature (HEX):

99e42b99bf324e740adcf253c466a41bbd62515a55c60c5c8f9077d07ed73e16a83f47a2455d8944165b824e6fc22a94bf9b2719c29aa68bac2271ed9ff46876

X-Processing-Signature (base64):

meQrmb8yTnQK3PJTxGakG71iUVpVxgxcj5B30H7XPhaoP0eiRV2JRBZbgk5vwiqUv5snGcKapousInHtn/Rodg==

获取 API 授权密钥​

IP 地址访问限制​

API 请求授权​

计算 X-Processing-Signature​

算法​

签名计算示例​

API 密钥​

请求​

计算步骤​