API接口列表

完整的API接口列表，包含所有可用的宝石拍卖数据接口

拍卖记录 获取宝石拍卖记录数据

GET /api/v1/auctions

获取拍卖记录列表

参数说明
参数名 类型 必填 默认值 说明
page integer 否 1 页码
limit integer 否 20 每页数量（最大100）
gem_name string 否 - 宝石类型筛选
origin string 否 - 产地筛选
auction_house string 否 - 拍卖行筛选
is_sold boolean 否 - 是否成交筛选
weight_min float 否 - 最小重量（克拉）
weight_max float 否 - 最大重量（克拉）
price_min integer 否 - 最低价格（美元）
price_max integer 否 - 最高价格（美元）
date_from date 否 - 开始日期
date_to date 否 - 结束日期
响应格式
{
    "success": "boolean",
    "data": "array",
    "pagination": "object",
    "meta": "object"
}
在线测试 查看示例
GET /api/v1/auctions/{id}

获取单个拍卖详情

参数说明
参数名 类型 必填 默认值 说明
id integer 是 - 拍卖记录ID
响应格式
{
    "success": "boolean",
    "data": "object"
}
在线测试 查看示例
GET /api/v1/auctions/latest

获取最新拍卖记录

参数说明
参数名 类型 必填 默认值 说明
limit integer 否 10 返回数量（最大50）
响应格式
{
    "success": "boolean",
    "data": "array"
}
在线测试 查看示例
GET /api/v1/auctions/search

搜索拍卖记录

参数说明
参数名 类型 必填 默认值 说明
q string 是 - 搜索关键词
page integer 否 1 页码
limit integer 否 20 每页数量
响应格式
{
    "success": "boolean",
    "data": "array",
    "search": "object"
}
在线测试 查看示例

统计数据 获取各种统计数据

GET /api/v1/stats

获取基础统计数据

响应格式
{
    "success": "boolean",
    "data": "object"
}
在线测试 查看示例
GET /api/v1/stats/market

获取市场统计数据

响应格式
{
    "success": "boolean",
    "data": "object"
}
在线测试 查看示例
GET /api/v1/stats/trends

获取趋势统计数据

响应格式
{
    "success": "boolean",
    "data": "object"
}
在线测试 查看示例
GET /api/v1/gemstones

获取宝石类型统计

响应格式
{
    "success": "boolean",
    "data": "array"
}
在线测试 查看示例
GET /api/v1/gemstones/{gemstone}

获取特定宝石类型数据

参数说明
参数名 类型 必填 默认值 说明
gemstone string 是 - 宝石类型名称
响应格式
{
    "success": "boolean",
    "data": "object"
}
在线测试 查看示例

价格排行 获取价格排行数据

GET /api/v1/rankings/top-price

获取最高价格排行

参数说明
参数名 类型 必填 默认值 说明
limit integer 否 10 返回数量
响应格式
{
    "success": "boolean",
    "data": "array"
}
在线测试 查看示例
GET /api/v1/rankings/price-per-carat

获取每克拉价格排行

参数说明
参数名 类型 必填 默认值 说明
limit integer 否 10 返回数量
响应格式
{
    "success": "boolean",
    "data": "array"
}
在线测试 查看示例

搜索建议 获取搜索建议

GET /api/v1/suggestions

获取搜索建议

参数说明
参数名 类型 必填 默认值 说明
q string 是 - 搜索关键词
响应格式
{
    "success": "boolean",
    "data": "array"
}
在线测试 查看示例