V兔API开放平台

名称	类型	必须	示例值	描述
shop_id	String	true		店铺 id
picture_category_id	Number	true	123	图片分类 ID，设置具体某个分类 ID 或设置 0 上传到默认分类，只能传入一个分类
img	Object	true	我是被上传的文件内容	图片二进制文件流，不能为空，允许 png、jpg、gif 图片格式，3M 以内。
image_input_title	String	true	Bule.jpg	包括后缀名的图片标题，不能为空，如 Bule.jpg,有些卖家希望图片上传后取图片文件的默认名
title	String	false	图片名称	图片标题，如果为空，传的图片标题就取去掉后缀名的 image_input_title,超过 50 字符长度会截取 50 字符，重名会在标题末尾加"(1)";标题末尾已经有"(数字)"了，则数字加 1
client_type	String	false	client:computer	图片上传的来源，有电脑版本宝贝发布，手机版本宝贝发布 client:computer 电脑版本宝贝使用，client:phone 手机版本宝贝使用。注意：当 client:phone 时，图片限制为宽度在 480-620 之间，长度不能超过 960，否则会报错。
is_https	Boolean	false	true	是否获取 https 连接
vvtype	int	false		增强版 2，增强版的需要传参 2,必须传 2

请求示例

{
shop_id:111
picture_category_id:1657717355974335419
vvtype:2
title:你好
image_input_title:7df.png
}

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

Pyton请求代码示例

响应参数

名称	类型	示例值	描述
picture	Picture		当前上传的一张图片信息
picture_id	Number	123	图片 ID
picture_category_id	Number	12	图片分类 ID
picture_path	String	http://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg	返回的是绝对路径如：http://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg
title	String	title	图片标题
sizes	Number	100	图片大小，bite 单位
pixel	String	450x150	图片相素，格式：长 x 宽，如 450x150
status	String	unfroze	图片状态，unfroze 代表没有被冻结，froze 代表被冻结，pass 代表排查通过
deleted	String	deleted	图片是否删除的标记
created	Date	2000-01-01 00:00:00	图片的创建时间
modified	Date	2000-01-01 00:00:00	图片的修改时间
client_type	String	client:computer 或者 client:phone	图片上传的来源，有电脑版本宝贝发布，手机版本宝贝发布
withholding_money	int		该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
     "withholding_money":4,
    {
    "picture_upload_response":{
        "picture":{
            "picture_id":123,
            "picture_category_id":12,
            "picture_path":"http:\/\/img07.taobaocdn.com\/imgextra\/i7\/22670458\/T2dD0kXb4cXXXXXXXX_!!22670458.jpg",
            "title":"title",
            "sizes":100,
            "pixel":"450x150",
            "status":"unfroze",
            "deleted":"deleted",
            "created":"2000-01-01 00:00:00",
            "modified":"2000-01-01 00:00:00",
            "client_type":"client:computer或者client:phone"
        }
    }
}
}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权