义乌购拍立淘API接入指南

Ace_31750887762025-06-17 15:26

一、接口概述

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

二、接入准备

makefile 复制代码

# 开发者注册示例（伪代码）
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"]

三、核心接口调用

图片上传接口

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

python 复制代码

 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)

响应数据结构

{ "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 } } ] } }

四、最佳实践

python 复制代码

图片预处理建议：

    分辨率建议800x800像素

    使用白色背景商品图

    避免水印和拼接图

错误处理：

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

五、QPS限制

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