?

在愛回收平臺上，用戶經常需要根據品牌ID和項目ID查詢相關商品或服務的價格。為此，平臺提供了一個簡潔高效的API接口，幫助開發者或第三方應用實現自動化價格查詢。本文將詳細介紹這個API的使用方法，包括接口描述、參數說明、請求示例、響應格式和錯誤處理。通過本文，您可以快速上手并集成該API到您的應用中。

1. API接口概述

該API是一個RESTful接口，用于查詢指定品牌和項目的價格信息。它基于HTTP GET方法，返回JSON格式的數據。接口的核心功能是根據用戶提供的品牌ID（brand_id）和項目ID（project_id）實時獲取價格數據。例如，在二手手機回收場景中，品牌ID可能對應手機品牌（如Apple），項目ID對應具體型號（如iPhone 12），API會返回該型號的回收估價。

接口URL: https://api.aihuishou.com/price/query

HTTP方法: GET

認證要求: 部分接口可能需要API密鑰（API key），但本接口通常無需認證，具體取決于平臺設置。建議在調用前查看官方文檔。

2. 請求參數

調用API時，需要傳遞以下必需參數作為查詢字符串（query string）：

brand_id: 字符串類型，表示品牌的唯一標識符。例如，"apple"對應蘋果品牌。

project_id: 字符串類型，表示項目的唯一標識符。例如，"iphone12"對應iPhone 12型號。

參數需通過URL編碼傳遞，格式如下：

https://api.aihuishou.com/price/query?brand_id=apple&project_id=iphone12

3. 請求示例

以下是使用不同工具調用API的示例：

使用curl命令

在命令行中，您可以直接使用curl發送GET請求：

curl "https://api.aihuishou.com/price/query?brand_id=apple&project_id=iphone12"

使用Python代碼

在Python中，您可以使用requests庫簡化調用過程。首先安裝庫：pip install requests。然后編寫函數：

import requests

def get_price(brand_id, project_id):
    url = "https://api.aihuishou.com/price/query"
    params = {
        "brand_id": brand_id,
        "project_id": project_id
    }
    response = requests.get(url, params=params)
    if response.status_code == 200:
        return response.json()
    else:
        raise Exception(f"API請求失敗，狀態碼：{response.status_code}")

# 示例調用
price_data = get_price("apple", "iphone12")
print(price_data)

4. 響應格式

API成功調用后，返回JSON對象，包含以下字段：

price: 浮點數類型，表示查詢到的價格，單位為人民幣（CNY）。例如，1000.0表示估價1000元。

currency: 字符串類型，表示貨幣單位，默認為"CNY"。

timestamp: 字符串類型，表示數據生成的時間戳，格式為ISO 8601，例如"2023-10-05T14:30:00Z"。

示例響應：

{
  "price": 1500.0,
  "currency": "CNY",
  "timestamp": "2023-10-05T08:45:22Z"
}

5. 錯誤處理

如果API調用失敗，會返回相應的HTTP狀態碼和錯誤信息。常見錯誤包括：

400 Bad Request: 參數缺失或無效，例如brand_id或project_id為空。

404 Not Found: 指定品牌或項目不存在。

500 Internal Server Error: 服務器內部錯誤，建議重試。

在代碼中，您可以處理這些錯誤：

try:
    price_data = get_price("apple", "iphone12")
    print(f"價格：{price_data['price']} {price_data['currency']}")
except Exception as e:
    print(f"錯誤：{e}")

6. 注意事項

頻率限制: 為防止濫用，API可能有限制調用頻率，例如每分鐘最多10次請求。超出限制會返回429錯誤。

數據更新: 價格數據實時更新，但緩存機制可能影響時效性，建議在關鍵操作前刷新查詢。

安全建議: 如果API需要認證，務必使用HTTPS并妥善保管API密鑰。

7. 總結

通過愛回收平臺的這個價格查詢API，開發者可以輕松集成品牌和項目相關的價格數據到自己的應用中，提升用戶體驗和自動化效率。本文提供了詳細的調用指南和代碼示例，幫助您快速實現功能。如果您在集成過程中遇到問題，建議參考官方文檔或社區支持。開始嘗試調用API，探索更多可能性吧！

?審核編輯 黃宇