okai-wang/gogetssl-sdk

GOGETSSL API Client using Guzzle

1.0.1 2025-09-11 14:12 UTC

Requires

• php: >=7.2
• guzzlehttp/guzzle: ^7.0

MIT

README

基于Guzzle的GOGETSSL API客户端库，支持所有文档中定义的API接口。

安装

composer require okai-wang/gogetssl-sdk

初始化

use Gogetssl\GogetsslClient;
use GuzzleHttp\Exception\GuzzleException;

// 初始化客户端
$client = new GogetsslClient('your_api_token', [
    // 可选的Guzzle配置
    'timeout' => 60,
    // 可以添加代理等其他配置
    // 'proxy' => 'http://proxy.example.com:8080',
]);

使用示例

产品相关

// 获取产品详情
try {
    $product = $client->getProductDetails(68);
    print_r($product);
} catch (GuzzleException $e) {
    echo "请求错误: " . $e->getMessage();
} catch (RuntimeException $e) {
    echo "API错误: " . $e->getMessage();
}

// 获取SSL产品列表
$products = $client->getSslProducts();

CSR相关

// 生成CSR
$csr = $client->generateCSR([
    'csr_commonname' => 'example.com',
    'csr_organization' => 'Example Inc',
    'csr_department' => 'IT',
    'csr_city' => 'New York',
    'csr_state' => 'NY',
    'csr_country' => 'US',
    'csr_email' => '[e-mail]'
]);

// 验证CSR
$validation = $client->validateCSR($csr['csr_code']);

订单管理

// 取消订单
$result = $client->cancelOrder(12345, '不再需要该服务');

// 获取发票列表
$invoices = $client->getInvoiceListByPeriod('2023-01-01', '2023-12-31');

错误处理

• 所有Guzzle相关错误会抛出GuzzleException
• API返回的错误会抛出RuntimeException
• JSON解析错误会抛出RuntimeException

### 注意事项

1. 请确保PHP版本 ≥ 7.2
2. 所有方法均可能抛出`GuzzleException`（网络错误）或`RuntimeException`（API错误）
3. 不需要认证的接口（如CSR生成/验证）已在内部处理`withAuth=false`
4. 详细参数要求请参考GOGETSSL API文档