API概览
15
接口总数
可用的API接口数量
4
接口分类
按功能分类的接口组
JSON
响应格式
统一的数据返回格式
1000 requests/hour
访问限制
每小时请求限制
快速开始
基础URL
https://www.zxnb.com
示例请求
GET https://www.zxnb.com/api/v1/auctions?page=1&limit=20示例响应
{
"success": true,
"data": [
{
"id": 30,
"title": "祖母绿",
"gem_type": "祖母绿",
"carat": 20.8,
"origin": "哥伦比亚",
"price_final_usd": 46153
}
],
"pagination": {
"current_page": 1,
"total_pages": 2,
"total_records": 25
}
}接口分类
拍卖记录
获取宝石拍卖记录数据
-
GET
/api/v1/auctions获取拍卖记录列表 -
GET
/api/v1/auctions/{id}获取单个拍卖详情 -
GET
/api/v1/auctions/latest获取最新拍卖记录 - ... 还有 1 个接口
统计数据
获取各种统计数据
-
GET
/api/v1/stats获取基础统计数据 -
GET
/api/v1/stats/market获取市场统计数据 -
GET
/api/v1/stats/trends获取趋势统计数据 - ... 还有 2 个接口
价格排行
获取价格排行数据
-
GET
/api/v1/rankings/top-price获取最高价格排行 -
GET
/api/v1/rankings/price-per-carat获取每克拉价格排行
搜索建议
获取搜索建议
-
GET
/api/v1/suggestions获取搜索建议
使用示例
JavaScript 示例
// 获取拍卖记录
fetch("https://www.zxnb.com/api/v1/auctions?page=1&limit=20")
.then(response => response.json())
.then(data => {
console.log("拍卖记录:", data);
if (data.suc...PHP 示例
<?php
// 获取拍卖记录
$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);
...Python 示例
import requests
import json
# 获取拍卖记录
url = "https://www.zxnb.com/api/v1/auctions"
params = {
"page": 1,
"limit": 20
}
try:
response = requests.get(url, params=para...