API使用示例

提供多种编程语言的API调用示例,帮助您快速集成宝石拍卖数据

PHP示例

获取拍卖列表
<?php
// 使用 cURL 获取拍卖列表
$url = "https://www.zxnb.com/api/v1/auctions?page=1&limit=20";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Accept: application/json"
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    if ($data["success"]) {
        foreach ($data["data"] as $auction) {
            echo "拍卖ID: " . $auction["id"] . "\n";
            echo "宝石类型: " . $auction["gem_type"] . "\n";
            echo "克拉数: " . $auction["carat"] . "\n";
            echo "最终价格: $" . number_format($auction["price_final_usd"]) . "\n";
            echo "---\n";
        }
    }
} else {
    echo "请求失败,HTTP状态码: " . $httpCode;
}
?>
搜索宝石
<?php
// 搜索特定类型的宝石
$searchTerm = "祖母绿";
$url = "https://www.zxnb.com/api/v1/search?q=" . urlencode($searchTerm) . "&page=1&limit=10";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Accept: application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

if ($data["success"]) {
    echo "找到 " . count($data["data"]) . " 个结果\n";
    foreach ($data["data"] as $result) {
        echo "- " . $result["title"] . " (" . $result["gem_type"] . ")\n";
    }
}
?>

错误处理

常见错误响应
HTTP状态码 错误类型 说明 解决方案
400 Bad Request 请求参数错误 检查请求参数格式和必填字段
401 Unauthorized 未授权访问 检查API密钥或认证信息
429 Too Many Requests 请求频率超限 降低请求频率,等待一段时间后重试
500 Internal Server Error 服务器内部错误 稍后重试或联系技术支持