Skip to content

认证方式

认证方式

Dipcoin Perpetual API 使用 JWT (JSON Web Token) 进行身份认证。

认证流程

  1. 获取 JWT Token: 通过钱包签名调用认证接口获取 Token
  2. 携带 Token: 在后续请求的请求头中携带 Token

请求头

私有接口请求头

名称 类型 必填 描述
Authorization string 是 JWT Token，格式：Bearer {token}
X-Wallet-Address string 是 钱包地址

注意

  • Token 需要在请求头中以 Bearer {token} 格式传递
  • X-Wallet-Address 必须是签名时使用的钱包地址
  • Token 具有有效期，过期后需要重新获取

认证示例

1. 获取 JWT Token

POST /api/authorize
Content-Type: application/json

{
  "userAddress": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78",
  "signature": "77ac25a7a4e9c686447788d65e06366f11cc8d064fb2f8585bbce7b06cbd29b398f7b231cd4f838818688057236c9be2572b825d7d2b2d141594e7cffc98e40a1zTNoZKsgPhuhbBmPoAeD/D+135wtLJbw7luX1Nftd+M=",
  "isTermAccepted": true
}

响应： 

{
  "code": 200,
  "message": "success",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "walletAddress": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78"
  }
}

2. 使用 Token 调用私有接口

GET /api/perp-trade-api/curr-info/account
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
X-Wallet-Address: 0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78

签名说明

认证接口需要提供钱包签名，签名验证通过后才会生成 JWT Token。

提示

签名需要使用 Sui 钱包对特定消息进行签名，具体签名方式请参考钱包 SDK 文档。