item_search-根据关键词取商品列 测试此API onebound.ymatou.item_search
公共参数
名称 类型 必须 描述 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版本
请求参数
请求参数：q=连衣裙&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=
参数说明：q:关键词,没有其他参数
响应参数
Version: Date:
名称 类型 必须 示例值 描述 num_iid
String 0 b4834d4e-60eb-43ea-9314-16fe1e828b3b 商品ID title
String 0 tommy 女士连衣裙 黑白条纹 藏蓝色 商品标题 pic_url
String 0 pic1.ymatou.com/G02/shangou… 商品图片 promotion_price
Float 0 优惠价 price
Float 0 245 价格 sales
Int 0 销量 sample_id
String 0 商品风格标识ID seller_nick
String 0 小牛儿美淘 卖家昵称 seller_pic
String 0 pic1.ymatou.com/G02/M05/58/… 卖家头像 area
String 0 美国 店铺所在地 post_fee
Float 0 物流费用 detail_url
String 0 www.ymatou.com/product/b48… 物流费用
请求示例
Curl PHP PHPsdk JAVA C# Python
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "api-gw.onebound.cn/ymatou/item…<您自己的apiKey>&secret=<您自己的apiSecret>&q=连衣裙&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="
响应示例
异常示例
相关资料
错误码解释
状态代码(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 未知错误 否
