接口说明
根据获取号码时返回的 PID 查询短信内容。收到短信后,返回结果中的 smsData 包含完整短信正文。
请求方式
GET /splatform/getCodeData
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
uKey | string | 是 | 用户 API Key。 |
PID | string | 是 | 获取号码接口返回的 PID。 |
projectID | string | 是 | 项目 ID,必须与该 PID 对应。 |
请求示例
GET /splatform/getCodeData?uKey=YOUR_UKEY&PID=1157123308979568&projectID=10000
成功返回示例
{
"ret": 0,
"msg": "Success",
"smsData": "Your WhatsApp code: 965-442 Don't share this code with others"
}
状态处理
| ret | 状态 | 建议处理 |
|---|---|---|
0 | 成功返回短信 | 读取 smsData 并停止轮询。 |
3 | 等待收码 | 按合理间隔继续查询。 |
2 | 号码已经收码 | 检查此前返回结果或业务状态。 |
12 | 到码且已主动释放 | 号码已结束使用。 |
17 | 到码后系统自动释放 | 短信内容可能已随释放处理。 |
18 | 收到码但短信内容为空 | 可能已被释放或数据不可用。 |
-99 | 请求频率过快 | 立即降低轮询频率。 |
轮询建议
收到 ret=0 或其他终态后应立即停止查询。不要在多个线程中同时高频轮询同一个 PID。