开发文档

<form id="verify-form">
  <input id="card-input" placeholder="请输入卡密">
  <button type="submit">验证</button>
</form>
<p id="verify-result"></p>

<script>
const API_KEY  = 'pk_请替换成你的APIKey';
const API_URL  = 'https://cloud.spent.cc/api/verify.php';

// 生成并持久化一个浏览器设备标识（仅作示例，可按需替换）
function getDeviceId() {
  let id = localStorage.getItem('cloud_device_id');
  if (!id) {
    id = 'web-' + (crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).slice(2));
    localStorage.setItem('cloud_device_id', id);
  }
  return id;
}

document.getElementById('verify-form').addEventListener('submit', async (event) => {
  event.preventDefault();
  const resultEl = document.getElementById('verify-result');
  resultEl.textContent = '验证中...';

  try {
    const response = await fetch(API_URL, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        key:    API_KEY,
        card:   document.getElementById('card-input').value.trim(),
        device: getDeviceId()
      })
    });

    const result = await response.json();
    resultEl.textContent = result.ok
      ? '验证成功，剩余 ' + result.data.remaining + ' 次'
      : '验证失败（' + result.code + '）：' + result.msg;
  } catch (error) {
    resultEl.textContent = '网络错误：' + error.message;
  }
});
</script>

"""云验证 Python 示例（仅使用标准库，无需额外依赖）"""
import json
import urllib.request

API_KEY = "pk_请替换成你的APIKey"
API_URL = "https://cloud.spent.cc/api/verify.php"


def verify_card(card: str, device: str) -> dict:
    """验证成功时平台会扣减 1 次，失败不会扣减"""
    payload = json.dumps({
        "key": API_KEY,
        "card": card,
        "device": device,
    }).encode("utf-8")

    request = urllib.request.Request(
        API_URL,
        data=payload,
        headers={"Content-Type": "application/json"},
        method="POST",
    )

    try:
        with urllib.request.urlopen(request, timeout=8) as response:
            return json.loads(response.read().decode("utf-8"))
    except Exception as exc:
        return {"ok": False, "code": -1, "msg": f"请求失败: {exc}"}


if __name__ == "__main__":
    result = verify_card("ABCD-EFGH-JKLM-NPQR", "desktop-device-001")
    if result.get("ok"):
        print("验证成功，剩余", result["data"]["remaining"], "次")
    else:
        print("验证失败：", result.get("msg"))

// Android 示例（API 21+）
// 请在 AndroidManifest.xml 中声明网络权限：
// <uses-permission android:name="android.permission.INTERNET" />

import org.json.JSONObject;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;

public final class CloudVerify {
    private static final String API_KEY = "pk_请替换成你的APIKey";
    private static final String API_URL = "https://cloud.spent.cc/api/verify.php";

    /** 必须在子线程调用，Android 禁止主线程发起网络请求 */
    public static JSONObject verify(String card, String deviceId) throws Exception {
        URL url = new URL(API_URL);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("POST");
        conn.setConnectTimeout(8000);
        conn.setReadTimeout(8000);
        conn.setDoOutput(true);
        conn.setRequestProperty("Content-Type", "application/json");

        JSONObject payload = new JSONObject();
        payload.put("key", API_KEY);
        payload.put("card", card);
        payload.put("device", deviceId);

        try (OutputStream out = conn.getOutputStream()) {
            out.write(payload.toString().getBytes(StandardCharsets.UTF_8));
        }

        int status = conn.getResponseCode();
        BufferedReader reader = new BufferedReader(new InputStreamReader(
                (status >= 200 && status < 300) ? conn.getInputStream() : conn.getErrorStream(),
                StandardCharsets.UTF_8));

        StringBuilder body = new StringBuilder();
        String line;
        while ((line = reader.readLine()) != null) {
            body.append(line);
        }
        reader.close();
        conn.disconnect();

        return new JSONObject(body.toString());
    }
}

// 调用示例（子线程）：
// String deviceId = Settings.Secure.getString(
//         getContentResolver(), Settings.Secure.ANDROID_ID);
// JSONObject result = CloudVerify.verify(card, deviceId);
// if (result.optBoolean("ok")) {
//     int remaining = result.getJSONObject("data").optInt("remaining");
// }