程序化访问

公开 API

商品目录、库存、余额和订单。密钥由您在个人中心自行创建，也可以直接在这里测试请求——沙盒会直接从浏览器发起调用。

https://mawgli.men/api/v1

没有 api.mawgli.men 之类的单独地址——所有请求都发送到这里

方法	地址	作用	密钥	限额
GET	/health	检查密钥和连接	需要	60/分钟
GET	/categories	商品分类：商品数量和“起价”	需要	60/分钟
GET	/products	商品目录：货号、名称、库存、价格、批量	需要	60/分钟
GET	/products/{id}	单个商品的完整信息	需要	60/分钟
GET	/instant	仅即时发货的商品	需要	60/分钟
GET	/balance	余额及该密钥的累计金额	需要	60/分钟
GET	/orders	订单列表，每页 50 条	需要	60/分钟
GET	/orders/{id}	单个订单及其发货内容	需要	60/分钟
GET	/usage	该密钥的请求计数和最近一次调用	需要	60/分钟
POST	/orders	创建订单并用余额支付	需要	60/分钟
POST	/balance/topup	获取充值转账信息	需要	60/分钟

表格可左右滑动：最右侧是「密钥」和「限额」两列。

如何接入

密钥和 secret 在个人中心创建。GET 请求只需密钥；POST 请求（下单和充值）必须带签名。

X-API-Key

个人中心生成的密钥，32 个字符

始终需要

X-Timestamp

以秒为单位的时间（unix），与服务器时间相差不超过 5 分钟

POST 请求需要

X-Signature

用 secret 对“timestamp + 换行 + 请求体”计算的 HMAC-SHA256；同一签名只接受一次

POST 请求需要

curl https://mawgli.men/api/v1/products \
  -H "X-API-Key: 7f3a2c91b40e4dd6a810c5e2f19b7d34"

响应代码

200

正常

400

请求被拒绝：数量低于最低批量、网络不受支持或参数无效

401

密钥缺失、未被接受或签名校验失败

402

余额不足

403

IP 地址不在该密钥的白名单中

404

未找到商品或订单

409

库存不足或商品已被其他买家占用

429

限额已用尽——请在 Retry-After 指定的秒数后重试

501

暂不支持发票付款——请使用 payment_method balance

503

服务或网络暂时不可用——请稍后重试

限额

不超过

每个密钥每分钟请求数

超出限额时返回代码 429 和 Retry-After 响应头——表示多少秒后可以重试。

响应内容

{
  "total": 6,
  "page": 1,
  "page_size": 50,
  "items": [
    {
      "sku": 200546,
      "title": "Instagram | Авторег API | Отлежка 4+ мес. | Рег. 03.2026 | 2FA",
      "category": "autoreg_aged",
      "quantity": 30,
      "min_quantity": 1,
      "price_usdt": 0.41,
      "instant_delivery": true,
      "instant_stock": 12
    }
  ]
}

API 订单退款为人工处理

通过 API 用余额支付的订单如果未能完成，资金不会自动退回。请带上订单号联系客服——我们核实后会人工退款。网站和机器人中也是如此。

直接在这里试试

请求从您的浏览器发出。密钥不会保存在服务器上。

密钥

保存在此设备的 sessionStorage 中。

SECRET

仅用于签名 POST 请求；保存在此设备的 sessionStorage 中。

接口

请求直接从您的浏览器发出。密钥不会保存在服务器的任何地方。

响应

// 在上方选择接口并点击“执行”