贝壳物联图片接口协议,http协议接口。
对指定的URL发起一个HTTP POST请求,会为指定的图片接口上传一幅新的图像, 使用此API来为图片接口存储图像数据, 目前只支持上传jpg, png, gif类型的图像.
https://www.bigiot.net/pubapi/uploadImg/did/<did>/inputid/<inputid>
参数名 | 必需 | 类型 | 说明 |
did | true | string | 设备ID |
input | true | string | 接口ID |
API-KEY | true | string | 设备APIKEY,http header内 |
binary
注意:此处格式与数值型传感器等不同,不再使用JSON格式,而是直接上传图片的原始内容
POST
{"M":"uploadImg","R":"xxx"}
xxx——返回代码,0、1、-1、-2、-3、-4
0:上传失败;
1:上传成功;
-1:APIKEY错误;
-2:上传参数不全或错误;
-3:接口不属于该设备;
-4:接口非图片接口。
Note: json字符串末尾无“\n”。
需要在HTTP Header中增加API-KEY来授权写入操作, 支持一次传送一幅图像数据.
curl --request POST -F "data=@/home/pi/bigiot.png" --header "API-KEY: dxx3db14b" https://www.bigiot.net/pubapi/uploadImg/did/449/inputid/844
Note:需要在HTTP Header中增加API-Key来授权写入操作, 支持一次传送一幅图像数据;
Note:目前限定相邻图像数据上传间隔须大于等于10s;
Note:图片大小不大于100K;
Note:图片格式jpg、png、gif。