图片接口协议(https)

贝壳物联图片接口协议,http协议接口。

图片接口协议

对指定的URL发起一个HTTP POST请求,会为指定的图片接口上传一幅新的图像, 使用此API来为图片接口存储图像数据, 目前只支持上传jpg, png, gif类型的图像.

一、URL

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格式,而是直接上传图片的原始内容

四、Method

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。

     



上一篇:用户等级及权限说明
下一篇:UDP通讯协议
返回顶部