信息推送 联系客服 查询订单 登录

🔌 API接口文档

使用API接口进行批量操作，提高效率

提示：请先登录并在个人中心获取您的API Key

🚀 快速开始

API基础地址：https://hdd.cm/api

认证方式：在请求参数中传递 apiKey

响应格式：JSON

💳 商品购买接口

POST /api/purchase
请求参数
参数名 类型 必填 说明
apiKey string 是 您的API密钥
goods_id integer 是 商品ID
BuyAmount integer 否 购买数量（默认1）
请求示例
curl -X POST https://hdd.cm/api/purchase \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "goods_id": 1,
    "BuyAmount": 10
  }'
<?php
$url = "https://hdd.cm/api/purchase";
$data = [
    "apiKey" => "YOUR_API_KEY",
    "goods_id" => 1,
    "BuyAmount" => 10
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
import requests
import json

url = "https://hdd.cm/api/purchase"
data = {
    "apiKey": "YOUR_API_KEY",
    "goods_id": 1,
    "BuyAmount": 10
}

response = requests.post(url, json=data)
result = response.json()
print(result)
响应示例
{
  "code": 0,
  "message": "购买成功",
  "data": {
    "buy_amount": 10,
    "last_balance": 1000.00,
    "now_balance": 900.00,
    "order_sn": "API-1-20240101120000",
    "price": 10.00,
    "search_pwd": "ABC123",
    "twitter_list": [
      "卡密内容1",
      "卡密内容2",
      ...
    ]
  }
}

📊 库存查询接口

POST GET /api/check-stock
请求参数
参数名 类型 必填 说明
goods_id integer 是 商品ID
apiKey string 否 API密钥（用于获取代理价）
请求示例
curl -X POST https://hdd.cm/api/check-stock \
  -H "Content-Type: application/json" \
  -d '{
    "goods_id": 1,
    "apiKey": "YOUR_API_KEY"
  }'
响应示例
{
  "code": 0,
  "message": "查询成功",
  "data": {
    "goods_id": 1,
    "goods_name": "商品名称",
    "available_stock": 100,
    "goods_type": "自动发货",
    "is_open": "已上架",
    "buy_limit_num": "无限制",
    "min_buy_num": 1,
    "price_info": {
      "actual_price": 10.00,
      "agent_price": 8.00,
      "user_grade": 1
    }
  }
}
POST GET /api/batch-check-stock
请求参数
参数名 类型 必填 说明
goods_ids array/string 是 商品ID数组或逗号分隔字符串（最多50个）
apiKey string 否 API密钥（用于获取代理价）
请求示例
curl -X POST https://hdd.cm/api/batch-check-stock \
  -H "Content-Type: application/json" \
  -d '{
    "goods_ids": [1, 2, 3, 4, 5],
    "apiKey": "YOUR_API_KEY"
  }'

❌ 错误码说明

错误码 说明 解决方案
-1 请求失败 检查请求参数是否正确
0 请求成功 -
apiKey无效 API密钥不存在或错误 检查API Key是否正确
余额不足 账户余额不足以完成购买 请先充值
库存不足 商品库存不足 减少购买数量或选择其他商品
商品不存在 指定的商品ID不存在 检查商品ID是否正确
商品未上架 商品已下架 选择其他商品

⚠️ 注意事项

  • API Key请妥善保管，不要泄露给他人
  • 所有API请求都需要在参数中包含有效的apiKey
  • 批量查询接口一次最多查询50个商品
  • 购买接口会从账户余额中扣除相应金额
  • 自动发货商品购买成功后会立即返回卡密内容
  • 人工发货商品需要等待处理
  • 建议在生产环境中使用HTTPS协议
Powered by @号多多