上传图片
上传指定类型图片的base64编码,通过校验上传成功后图片会被保存到账户图库并返回图片ID和图片URL。图片要求:JPG、JPEG、PNG格式,大小100K以内,其中移动配图宽高最低为200px,最高为600px,比例1:1,计算机配图宽高最低为121px75px,最高为363px225px,比例区间为[1.60:1, 1.63:1]。请注意,此接口为批量接口,但是如果一组上传中有一张图片校验失败,整组请求都会失败。(允许上传gif格式图片,图片比例121:75,宽高最低为121px75px,最高为363px225px,大小低于600K)
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/pichouse/upload
字段 |
类型 |
必须 |
描述 |
Content-Type |
string |
yes |
application/x-www-form-urlencoded |
apiKey |
string |
yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken |
string |
yes |
访问token |
Body 请求参数
字段 |
类型 |
必须 |
描述 |
picList |
string |
yes |
json格式图片数组。单次请求上限10张。图片传base64编码,可以同步上传标签[{"tags":["标签1","标签2"],"picture":"base64编码"},{"tags":["标签3","标签4"],"picture":"base64编码"}] |
type |
string |
yes |
图片投放端类型,会影响到图片校验,creative_mobile表示移动创意配图,creative_computer表示计算机创意配图。 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'picList=[{"tags":["标签1","标签2"],"picture":"base64编码"},{"tags":["标签3","标签4"],"picture":"base64编码"}]&type=creative_mobile' \
'https://api.e.360.cn/dianjing/pichouse/upload'
返回结果
{
"picList":[
{
"id": "556",
"picUrl": "http://p4.qhimg.com/t013acf6f5865823c8d.jpg"
}
]
}
返回结果说明
字段 |
类型 |
描述 |
picList |
string |
图片ID列表,图片ID为图片的唯一标识,可用来绑定在推广组上。 |