身份认证（路径 B）

适用于 list / buy / status / wx_sph_* / user 等需登录接口。均为 POST（除非另行说明）。

参数	必填	说明
username	是	API 用户名（部分环境可用手机号字段，以开户约定为准）
sid	是	当前 Unix 时间戳（秒）；须为数字
sign	是	`md5(username + 密码明文 + sid)`，32 位小写

计算示例

假设：username=demo，密码 pass123，sid=1730000000

# 拼接串（中间无加号、无空格）
demo + pass123 + 1730000000
→ demopass1231730000000

sign = md5("demopass1231730000000")
# 注意：password 是登录密码原文，不要对已 MD5 的串再 MD5

PHP

$username = 'demo';
$password = 'pass123';
$sid = (string)time();
$sign = md5($username . $password . $sid);

Python

import hashlib, time
username, password = 'demo', 'pass123'
sid = str(int(time.time()))
sign = hashlib.md5((username + password + sid).encode()).hexdigest()

Node.js

const crypto = require('crypto');
const username = 'demo', password = 'pass123';
const sid = String(Math.floor(Date.now()/1000));
const sign = crypto.createHash('md5')
  .update(username + password + sid).digest('hex');

规则

|服务器时间 - sid| 超过约 600 秒会失败，请校准 NTP
账户冻结、IP 不在白名单、签名错误均会返回身份相关错误
Content-Type 可为 application/x-www-form-urlencoded 或 JSON（以联调为准）

统一返回

{ "code": 0, "msg": "ok", "data": {} }
# code = 0 成功；非 0 失败，以 msg 为准

完整 curl 串联示例见左侧「联调示例」。