API使用示例

<?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";
            $price = $auction["price_final_usd"] ?? null;
            $priceText = is_numeric($price) && $price > 0 ? "USD " . number_format((float)$price, 2) : "未披露";
            echo "最终价格: " . $priceText . "\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";
    }
}
?>

// 使用 fetch API 获取拍卖列表
async function getAuctions() {
    try {
        const response = await fetch("https://www.zxnb.com/api/v1/auctions?page=1&limit=20", {
            method: "GET",
            headers: {
                "Content-Type": "application/json",
                "Accept": "application/json"
            }
        });

        if (response.ok) {
            const data = await response.json();
            if (data.success) {
                data.data.forEach(auction => {
                    console.log(`拍卖ID: ${auction.id}`);
                    console.log(`宝石类型: ${auction.gem_type}`);
                    console.log(`克拉数: ${auction.carat}`);
                    const price = auction.price_final_usd;
                    const priceText = typeof price === "number" && Number.isFinite(price) && price > 0
                        ? `USD ${price.toLocaleString("en-US", {minimumFractionDigits: 2, maximumFractionDigits: 2})}` : "未披露";
                    console.log(`最终价格: ${priceText}`);
                    console.log("---");
                });
            }
        } else {
            console.error("请求失败:", response.status);
        }
    } catch (error) {
        console.error("请求错误:", error);
    }
}

// 调用函数
getAuctions();

// 搜索特定类型的宝石
async function searchGems(searchTerm) {
    try {
        const url = `https://www.zxnb.com/api/v1/search?q=${encodeURIComponent(searchTerm)}&page=1&limit=10`;
        const response = await fetch(url, {
            method: "GET",
            headers: {
                "Content-Type": "application/json",
                "Accept": "application/json"
            }
        });

        if (response.ok) {
            const data = await response.json();
            if (data.success) {
                console.log(`找到 ${data.data.length} 个结果`);
                data.data.forEach(result => {
                    console.log(`- ${result.title} (${result.gem_type})`);
                });
            }
        }
    } catch (error) {
        console.error("搜索错误:", error);
    }
}

// 搜索祖母绿
searchGems("祖母绿");

import requests
import json

# 获取拍卖列表
def get_auctions():
    url = "https://www.zxnb.com/api/v1/auctions"
    params = {
        "page": 1,
        "limit": 20
    }
    headers = {
        "Content-Type": "application/json",
        "Accept": "application/json"
    }
    
    try:
        response = requests.get(url, params=params, headers=headers)
        response.raise_for_status()
        
        data = response.json()
        if data["success"]:
            for auction in data["data"]:
                print(f"拍卖ID: {auction['id']}")
                print(f"宝石类型: {auction['gem_type']}")
                print(f"克拉数: {auction['carat']}")
                price = auction.get("price_final_usd")
                price_text = f"USD {price:,.2f}" if isinstance(price, (int, float)) and price > 0 else "未披露"
                print(f"最终价格: {price_text}")
                print("---")
        else:
            print("请求失败")
            
    except requests.exceptions.RequestException as e:
        print(f"请求错误: {e}")

# 调用函数
get_auctions()

import requests
import urllib.parse

# 搜索特定类型的宝石
def search_gems(search_term):
    url = "https://www.zxnb.com/api/v1/search"
    params = {
        "q": search_term,
        "page": 1,
        "limit": 10
    }
    headers = {
        "Content-Type": "application/json",
        "Accept": "application/json"
    }
    
    try:
        response = requests.get(url, params=params, headers=headers)
        response.raise_for_status()
        
        data = response.json()
        if data["success"]:
            print(f"找到 {len(data['data'])} 个结果")
            for result in data["data"]:
                print(f"- {result['title']} ({result['gem_type']})")
        else:
            print("搜索失败")
            
    except requests.exceptions.RequestException as e:
        print(f"搜索错误: {e}")

# 搜索祖母绿
search_gems("祖母绿")

curl -X GET "https://www.zxnb.com/api/v1/auctions?page=1&limit=20" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

curl -X GET "https://www.zxnb.com/api/v1/search?q=祖母绿&page=1&limit=10" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

curl -X GET "https://www.zxnb.com/api/v1/stats" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import org.json.JSONObject;
import org.json.JSONArray;

public class GemstoneAPI {
    private static final String BASE_URL = "https://www.zxnb.com/api/v1";
    
    public static void getAuctions() {
        try {
            HttpClient client = HttpClient.newHttpClient();
            HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(BASE_URL + "/auctions?page=1&limit=20"))
                .header("Content-Type", "application/json")
                .header("Accept", "application/json")
                .GET()
                .build();
            
            HttpResponse<String> response = client.send(request, 
                HttpResponse.BodyHandlers.ofString());
            
            if (response.statusCode() == 200) {
                JSONObject jsonResponse = new JSONObject(response.body());
                if (jsonResponse.getBoolean("success")) {
                    JSONArray data = jsonResponse.getJSONArray("data");
                    for (int i = 0; i < data.length(); i++) {
                        JSONObject auction = data.getJSONObject(i);
                        System.out.println("拍卖ID: " + auction.getInt("id"));
                        System.out.println("宝石类型: " + auction.getString("gem_type"));
                        System.out.println("克拉数: " + auction.getDouble("carat"));
                        String priceText = auction.isNull("price_final_usd") ? "未披露"
                            : "USD " + String.format(java.util.Locale.US, "%,.2f", auction.getBigDecimal("price_final_usd"));
                        System.out.println("最终价格: " + priceText);
                        System.out.println("---");
                    }
                }
            }
        } catch (Exception e) {
            System.err.println("请求错误: " + e.getMessage());
        }
    }
    
    public static void main(String[] args) {
        getAuctions();
    }
}