大喜哥出海工作室 API 对接文档
最后更新：2026-08-15 | 版本：1.0
基本信息
接口域名：xingmaofb.com
请求方式：GET（部分接口为 POST）
返回格式：JSON
认证方式：用户名 + 密码（GET 参数）
IP 白名单：所有请求需在授权 IP 中
编码：UTF-8
对接前请联系管理员将您服务器的公网 IP 加入白名单。
通用返回格式
{"status":"success","msg":"操作成功","data":{}}接口列表
查询余额
GET /api/GetBalance.php
参数：username, password
{"status":"success","msg":"查询余额成功","data":{"balance":1500.50}}
商品列表
GET /api/ListResource.php
参数：username, password
{"status":"success","categories":[...]}
商品详情
GET /api/InfoResource.php
参数：username, password, id
{"status":"success","product":{...}}
购买账号
GET /api/BResource.php
参数：username, password, id, amount
{"status":"success","msg":"订单已成功处理。","data":{"trans_id":"ABC123","amount":2,"lists":[{"account":"..."}]}}
自选购买 - 获取 UID
GET /api/get_uids.php
参数：username, password, product_id
{"status":"success","data":[{"id":1,"uid":"100012345678"},{"id":2,"uid":"100012345679"}]}
自选购买 - 提交
POST /api/buy_with_selection.php
参数：username, password, product_id, uids（逗号分隔）
{"status":"success","msg":"自选购买成功","data":{"trans_id":"XYZ","accounts":["账号1"]}}
常见错误
| 错误信息 | 说明 |
|---|---|
| 登录信息不正确 | 用户名或密码错误 |
| IP未授权 | 请求 IP 不在白名单中 |
| 对接余额不足 | 账号余额不足 |
| 系统中的数量不足 | 商品库存不足 |
| 该商品不允许通过API销售 | 该商品未开放 API |
| 系统繁忙，请稍后重试 | 购买失败（已自动退款） |
注意事项
- 购买接口为同步请求，建议客户端超时 ≥30 秒。
- “系统繁忙”代表购买未成功，款项已自动退回。
- 自选购买前请先刷新 UID 列表。
- 建议每日定时同步商品库存。
技术支持
如有任何对接问题，请联系 Telegram：@daxige