错误码

本章列出 /api/verify.php 可能返回的所有错误信息，便于客户端精确处理。错误信息主要通过 message 字段返回（无独立的 reason 字段）。

授权验证接口 (/api/verify.php)

易支付回调 (/epay_notify.php)

用户操作错误

错误处理最佳实践

客户端应该根据 message 关键词或 HTTP 状态码采取不同的处理：

<?php
function handle_verify_response($data, $http_code) {
    // 网络/HTTP 层错误
    if ($http_code === 429) {
        return ['show' => false, 'msg' => '', 'retry' => true];
    }
    if ($http_code === 503) {
        return ['show' => true,  'msg' => '授权服务暂不可用', 'retry' => true];
    }
    if ($http_code === 403) {
        error_log('[CRITICAL] License signature invalid');
        return ['show' => true,  'msg' => '授权服务异常，请联系插件作者', 'retry' => false];
    }

    // 业务层错误（HTTP 200 但 status !== success）
    if (($data['status'] ?? '') !== 'success') {
        $msg = $data['message'] ?? '验证失败';
        if (str_contains($msg, '过期')) {
            return ['show' => true, 'msg' => '授权已过期，请续费', 'retry' => false];
        }
        if (str_contains($msg, '暂停') || str_contains($msg, '吊销')) {
            return ['show' => true, 'msg' => '授权已被暂停/吊销，请联系客服', 'retry' => false];
        }
        if (str_contains($msg, '域名')) {
            return ['show' => true, 'msg' => '授权域名不匹配，请前往用户中心更换', 'retry' => false];
        }
        return ['show' => true, 'msg' => $msg, 'retry' => false];
    }

    // 成功
    return ['show' => false, 'msg' => '', 'retry' => false, 'info' => $data['license']];
}