授权

获取 API 授权密钥

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

按 IP 地址限制访问

为确保安全，API 的访问按 IP 地址进行限制。在个人账户中创建或编辑 API 密钥时，您必须指定一个允许的 IP 地址列表。

必需配置

未指定至少一个 IP 地址时，API 密钥无法激活。仅允许公网 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 密钥​

请求​

计算步骤​