银狼接码开放 API

通过标准 REST API 程序化购买海外手机号码、接收短信验证码。支持「长效号码」批量购买与「在线接码」按次取号两种业务模式。

API 基础地址

https://a.yljm.cc

所有接口路径均以 /api/v1 开头，完整地址 = 基础地址 + 接口路径，例如：

• 余额查询：https://a.yljm.cc/api/v1/user/info
• 项目列表：https://a.yljm.cc/api/v1/apps
• 在线取号：https://a.yljm.cc/api/v1/online/orders

快速开始

1. 前往 yljm.cc 注册账号 并完成充值；
2. 登录后进入 个人中心 → 开发者 API，点击「生成 API Key」；
3. 将 API Key 放入请求头 Authorization，发起第一个请求：

curl "https://a.yljm.cc/api/v1/user/info" \
  -H "Authorization: 你的API_KEY"

import requests

resp = requests.get(
    "https://a.yljm.cc/api/v1/user/info",
    headers={"Authorization": "你的API_KEY"},
)
print(resp.json())  # {'code': 1, 'msg': 'success', 'data': {...}}

const resp = await fetch("https://a.yljm.cc/api/v1/user/info", {
  headers: { Authorization: "你的API_KEY" },
});
console.log(await resp.json()); // { code: 1, msg: 'success', data: {...} }

req, _ := http.NewRequest("GET", "https://a.yljm.cc/api/v1/user/info", nil)
req.Header.Set("Authorization", "你的API_KEY")
resp, err := http.DefaultClient.Do(req)

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://a.yljm.cc/api/v1/user/info"))
    .header("Authorization", "你的API_KEY")
    .build();
HttpResponse<String> resp = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

鉴权方式

除「查询短信」外，全部接口都需要在请求头携带 API Key：

Authorization: 你的API_KEY
Content-Type: application/json

也支持 Authorization: Bearer 你的API_KEY 或 X-API-Key: 你的API_KEY 两种写法。

通用约定

所有接口返回 HTTP 200 + JSON 包裹结构（鉴权失败返回 HTTP 401/403）：

{
  "code": 1,          // 1=成功，0=业务失败（msg 为失败原因）
  "msg": "success",
  "data": { ... }     // 业务数据，失败时可能省略
}

• 请求体使用 JSON，需携带 Content-Type: application/json；
• 分页参数统一为 page（从 1 开始）与 limit；
• 金额单位为 USDT，时间为北京时间（UTC+8）。

余额查询

查询当前账户的用户名与余额。

请求示例

curl "https://a.yljm.cc/api/v1/user/info" -H "Authorization: 你的API_KEY"

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "id": 10001,
    "username": "demo",
    "balance": 88.5000
  }
}

限流与错误码

超限时返回 {"code":0,"msg":"操作过于频繁"}，请降低请求频率后重试。

常见问题

轮询频率建议是多少？

查询短信 / 在线取码建议 3～5 秒一次。在线接码号码有效期约 10 分钟，超时未收到验证码系统自动释放并全额退款。

可以退款吗？

在线接码在未收到验证码前可调用「释放」接口即时退款；长效号码按订单有效期计费，购买成功后不支持退款。

有沙箱环境吗？

暂无独立沙箱。所有读取类接口（项目列表、国家报价、余额）不产生扣费，可放心联调。