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 | 服务器内部错误 | 稍后重试或联系技术支持 |