义乌购拍立淘API接入指南

一、接口概述

拍立淘是义乌购平台提供的以图搜货服务，通过HTTP RESTful API实现。当前版本为v3.2，支持JPG/PNG格式图片（≤5MB），返回相似商品列表及供应链信息。

二、接入准备

申请开发者账号

# 开发者注册示例（伪代码）
import requests
auth_url = "https://open.yiwugo.com/oauth2/token"
params = {
    "client_id": "your_app_key",
    "client_secret": "your_app_secret",
    "grant_type": "client_credentials"
}
response = requests.post(auth_url, data=params)
access_token = response.json()["access_token"]

三、核心接口调用

1. 图片上传接口

   def image_search(image_path, token): url = "api.yiwugo.com/v3/image/se..." headers = {"Authorization": f"Bearer {token}"}

    with open(image_path, 'rb') as f:
        files = {'image': (image_path.split('/')[-1], f, 'image/jpeg')}
        response = requests.post(url, files=files, headers=headers)
    
    if response.status_code == 200:
        return response.json()["data"]["items"]
    else:
        raise Exception(f"API Error: {response.text}")

   调用示例

   results = image_search("product.jpg", access_token)

2. 响应数据结构

   { "code": 200, "data": { "items": { "product_id": "P123456", "similarity": 0.92, "price_range": \[2.5, 3.8, "main_image": "img.yiwugo.com/...", "supplier_info": { "company_id": "C7890", "gold_supplier": true } } ] } }

四、最佳实践

图片预处理建议：

    分辨率建议800x800像素

    使用白色背景商品图

    避免水印和拼接图

错误处理：

try:
    results = image_search("demo.jpg", token)
except Exception as e:
    print(f"搜索失败：{str(e)}")
    # 建议重试机制：间隔2秒重试3次

五、QPS限制

基础版：1次/秒 企业版：10次/秒（需签约）