🚀 开发者中心

✨ 平台特色

🚀 快速开始

📖 API 接口文档

基础接口

• POST /api.php?method=verify
  卡密验证
  验证卡密的有效性，并返回卡密信息
  请求参数

  参数	类型	必填	说明
  license_key	string	是	卡密密钥
  device_fingerprint	string	是	设备指纹

• POST /api.php?method=activate
  卡密激活
  激活卡密，绑定设备
• GET /api.php?method=status
  查询状态
  查询卡密使用状态和有效期
• POST /api.php?method=heartbeat
  心跳上报
  客户端心跳上报，保持在线状态

高级接口

• POST /api.php?method=unbind
  解绑设备
  解绑已绑定的设备（需要管理员权限）
• GET /api.php?method=statistics
  统计数据
  获取卡密使用统计数据

💻 示例代码

<?php
/**
 * 卡密验证示例
 */

$licenseKey = 'YOUR_LICENSE_KEY';
$deviceFingerprint = 'DEVICE_FINGERPRINT';
$apiUrl = 'http://geo.com/api.php?method=verify';

// 构建请求数据
$data = [
    'license_key' => $licenseKey,
    'device_fingerprint' => $deviceFingerprint,
    'timestamp' => time()
];

// 发送 POST 请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

// 解析响应
$result = json_decode($response, true);

if ($result['code'] === 200) {
    echo "验证成功！";
    print_r($result['data']);
} else {
    echo "验证失败：" . $result['message'];
}
?>

/**
 * 卡密验证示例
 */

async function verifyLicense(licenseKey, deviceFingerprint) {
    const apiUrl = 'http://geo.com/api.php?method=verify';
    
    const data = {
        license_key: licenseKey,
        device_fingerprint: deviceFingerprint,
        timestamp: Math.floor(Date.now() / 1000)
    };
    
    try {
        const response = await fetch(apiUrl, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(data)
        });
        
        const result = await response.json();
        
        if (result.code === 200) {
            console.log('验证成功！', result.data);
            return result.data;
        } else {
            console.error('验证失败：', result.message);
            throw new Error(result.message);
        }
    } catch (error) {
        console.error('请求失败：', error);
        throw error;
    }
}

// 使用示例
verifyLicense('YOUR_LICENSE_KEY', 'DEVICE_FINGERPRINT')
    .then(data => {
        console.log('卡密信息：', data);
    })
    .catch(error => {
        console.error('错误：', error);
    });

# 卡密验证
curl -X POST "http://geo.com/api.php?method=verify" \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "YOUR_LICENSE_KEY",
    "device_fingerprint": "DEVICE_FINGERPRINT",
    "timestamp": 1234567890
  }'

# 查询卡密状态
curl -X GET "http://geo.com/api.php?method=status&license_key=YOUR_LICENSE_KEY"

❓ 常见问题

1. 如何获取 API 访问权限？

登录后台，在「开发者中心」申请 API 访问权限，审核通过后即可获得 AppID 和 AppSecret。

2. API 调用频率有限制吗？

是的，为了保证系统稳定性，API 调用频率限制为每分钟 100 次。如需更高频率，请联系客服。

3. 返回的错误码有哪些？

4. 如何测试 API？

我们提供了测试环境，您可以在测试环境中免费测试 API 功能。测试环境地址：http://test.geo.com/api.php

📞 联系技术支持

在开发过程中遇到任何问题，都可以通过以下方式联系我们：