WordPress网站接入三网H5游戏API实现集成与数据同步

我们面临的问题是，如何将现有的WordPress网站与三网h5游戏平台进行API集成，实现用户数据、游戏进度和支付信息的双向同步。经过对百度热搜、CSDN、知乎等平台的技术讨论区进行搜索，发现用户最关注的具体查询包括：“WordPress接入三网H5游戏API实现用户登录同步”、“如何通过WordPress hooks调用三网H5游戏REST API更新游戏状态”、“WordPress与三网H5游戏数据同步失败解决方法”、“在三网H5游戏API中获取WordPress用户信息实现单点登录”、“WordPress自定义字段与三网H5游戏数据库字段映射配置”。

集成三网H5游戏API的准备工作

首先需要获取三网H5游戏平台的API密钥和接口文档。通过发送HTTP GET请求到 https://api.sanwanggame.com/v2/auth 接口，携带参数 client_id 和 client_secret 获取access_token。以下是一个使用PHP cURL实现获取access_token的代码示例：

function getSanwangGameAccessToken() {
    $client_id = 'your_client_id';
    $client_secret = 'your_client_secret';
    $url = 'https://api.sanwanggame.com/v2/auth';
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
        'client_id' => $client_id,
        'client_secret' => $client_secret,
        'grant_type' => 'client_credentials'
    ]));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    if(curl_errno($ch)) {
        return false;
    }
    curl_close($ch);
    
    $data = json_decode($response, true);
    return $data['access_token'] ?? false;
}

这段代码会返回一个有效期约60分钟的access_token，需要存储在WordPress的选项表中。使用以下WordPress函数保存access_token：

function saveSanwangGameAccessToken($token) {
    update_option('sanwang_game_access_token', $token);
    update_option('sanwang_game_token_expires', time() + 3600);
}

同时需要创建一个定时任务，每30分钟检查一次access_token是否过期，如果过期则重新获取。

实现WordPress用户与三网H5游戏账号绑定

通过三网H5游戏API的 /user/binding 接口实现用户绑定。当用户在WordPress网站注册或登录时，调用该接口传递用户唯一标识。以下是绑定流程的代码实现：

function bindUserToSanwangGame($user_id) {
    $access_token = get_option('sanwang_game_access_token');
    if (!$access_token) return false;
    
    $user_email = get_user_by('ID', $user_id)->user_email;
    $user_phone = get_user_meta($user_id, 'user_phone', true);
    
    $url = 'https://api.sanwanggame.com/v2/user/binding';
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
        'source_id' => $user_id,
        'source_type' => 'wordpress',
        'user_info' => [
            'email' => $user_email,
            'phone' => $user_phone
        ]
    ]));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Authorization: Bearer ' . $access_token,
        'Content-Type: application/json'
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    if(curl_errno($ch)) {
        return false;
    }
    curl_close($ch);
    
    return json_decode($response, true);
}

成功绑定后，三网H5游戏平台会返回一个binding_id，需要将其保存到WordPress用户meta中。这样当用户再次访问时，可以通过binding_id查询到用户的游戏状态。

实时同步游戏进度数据

通过三网H5游戏API的 /game/progress 接口同步游戏进度。可以在WordPress的save_post钩子中检测到游戏进度更新，然后调用该接口。以下是一个示例代码：

function syncGameProgress($post_id, $post) {
    if ($post->post_type !== 'game_progress') return;
    
    $access_token = get_option('sanwang_game_access_token');
    if (!$access_token) return;
    
    $user_id = get_current_user_id();
    $binding_id = get_user_meta($user_id, 'sanwang_game_binding_id', true);
    
    if (!$binding_id) return;
    
    $progress_data = get_post_meta($post_id, 'progress_data', true);
    
    $url = 'https://api.sanwanggame.com/v2/game/progress';
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
        'binding_id' => $binding_id,
        'progress_data' => $progress_data
    ]));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Authorization: Bearer ' => $access_token,
        'Content-Type: application/json'
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    curl_exec($ch);
    curl_close($ch);
}

为了确保数据实时性，建议使用WordPress的 wp_Cron 功能，每5分钟主动查询三网H5游戏API获取最新的游戏进度，并更新到WordPress自定义字段中。

处理支付信息同步

通过三网H5游戏API的 /payment/callback 接口处理支付回调。需要在WordPress中创建一个接收POST请求的页面，处理三网H5游戏发送的支付通知。以下是一个示例代码：

function handleSanwangGamePaymentCallback() {
    check_ajax_referer('sanwang_game_payment');
    
    $data = json_decode(file_get_contents('php://input'), true);
    $access_token = $_POST['access_token'] ?? '';
    
    // 验证access_token
    if (!$access_token || !verifySanwangGameAccessToken($access_token)) {
        wp_send_json_error();
        exit;
    }
    
    $payment_data = $data['payment_data'];
    // 处理支付数据
    // ...
    
    wp_send_json_success();
}

支付处理流程包括验证签名、更新订单状态、记录支付流水等步骤。成功处理后，需要向三网H5游戏平台发送POST请求到 /payment/acknowledge 接口，告知支付已完成。

解决常见集成问题

在实际集成过程中，用户经常遇到以下问题：

对于API请求失败的情况，建议实现重试机制。以下是一个重试逻辑的代码示例：

function makeCurlRequestWithRetry($url, $data, $max_attempts = 3) {
    $attempts = 0;
    while ($attempts < $max_attempts) {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_POST, true);
        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);
        $error = curl_error($ch);
        
        curl_close($ch);
        
        if (!$error) {
            return json_decode($response, true);
        }
        
        $attempts++;
        sleep(2);
    }
    
    return false;
}

此外，需要特别注意API接口的调用频率限制。三网H5游戏平台规定，每个IP每分钟最多只能发送100个请求。如果网站流量较大，需要考虑使用消息队列（如RabbitMQ）缓存请求，避免触发频率限制。