api接口的使用各位已经不陌生了，合理的利用可以是我们的工作更加便利，接下来分享一些已经可以使用的接口，希望对各位有所帮助

 

  • yiwugo.readme接入文档
  • item_search根据关键词取商品列表
  • item_get根据ID取商品详情
  • seller_info获得店铺详情
  • item_search_img按图搜索义乌购商品（拍立淘）
  • upload_img上传图片到义乌购

onebound.yiwugo.item_get 前往测试


公共参数

请求地址: https://api-gw.onebound.cn/yiwugo/item_get

名称

类型

必须

描述

key

String

是

调用key（必须以GET方式拼接在URL中）

secret

String

是

调用密钥

api_name

String

是

API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]

cache

String

否

[yes,no]默认yes，将调用缓存的数据，速度比较快

result_type

String

否

[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读

lang

String

否

[cn,en,ru]翻译语言，默认cn简体中文

version

String

否

API版本


请求参数

请求参数：num_iid=931405691

参数说明：num_iid:商品ID


响应参数

Version: Date:

名称

类型

必须

示例值

描述

num_iid

String

0

931405691

宝贝ID

title

String

0

商品标题

desc_short

String

0

商品简介

pic_url

String

0

//img1.yiwugou.com/i004/2020/05/16/40/49909083d829a807db6af05f3fad993e.png

宝贝图片

min_num

Int

0

1

num

Int

0

2191

express_fee

Float

0

EMS费用

shipping_to

String

0

shipping_to

发货至

nick

String

0

卫红女装制衣厂义乌篁园市场

卖家昵称

detail_url

String

0

http://www.yiwugo.com/product/detail/931405691.html

宝贝链接

desc

String

0


seller_id

Int

0

卖家ID

sales

Int

0

销售额

seller_info

Mix

0

{"desc": "卫红女装制衣厂实体经营中高档女装，款式新颖价格实惠，欢迎全国各地的顾客前来咨询订购", "dizhi": "", "nick": "卫红女装制衣厂义乌篁园市场", "seller_name": "", "user_num_id": "", "phone": "", "QQ": ""}

卖家信息

shop_id

Int

0

店铺ID

item_imgs

Mix

0

[{"url": "//img1.yiwugou.com/i004/2020/05/16/40/49909083d829a807db6af05f3fad993e.png"}]

商品图片列表

props_list

Mix

0

{}

商品属性

skus

Mix

0

{"sku": [{"properties": "0:0", "properties_name": "0:0:颜色:小号", "price": "7.70", "orginal_price": "7.70", "quantity": 716, "sku_id": 3184603612387 }]}

商品规格信息列表

price

Float

0

149

价格


请求示例

  • Curl
  • PHP
  • PHPsdk
  • JAVA
  • C#
  • Python
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/yiwugo/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=931405691"

响应示例


异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "1688",
  "request_id": "15ee0ffc041242"
}

相关资料

错误码解释

状态代码(error_code)

状态信息

详细描述

是否收费

0000

success

接口调用成功并返回相关数据

是

2000

Search success but no result

接口访问成功，但是搜索没有结果

是

4000

Server internal error

服务器内部错误

否

4001

Network error

网络错误

否

4002

Target server error

目标服务器错误

否

4003

Param error

用户输入参数错误

忽略

4004

Account not found

用户帐号不存在

忽略

4005

Invalid authentication credentials

授权失败

忽略

4006

API stopped

您的当前API已停用

忽略

4007

Account stopped

您的账户已停用

忽略

4008

API rate limit exceeded

并发已达上限

忽略

4009

API maintenance

API维护中

忽略

4010

API not found with these values

API不存在

忽略

4012

Please add api first

请先添加api

忽略

4013

Number of calls exceeded

调用次数超限

忽略

4014

Missing url param

参数缺失

忽略

4015

Wrong pageToken

参数pageToken有误

忽略

4016

Insufficient balance

余额不足

忽略

4017

timeout error

请求超时

否

5000

unknown error

未知错误

否