貝殼物聯圖片接口協議,http協議接口。
對指定的URL發起一個HTTP POST請求,會為指定的圖片接口上傳一幅新的圖像, 使用此API來為圖片接口存儲圖像數據, 目前只支持上傳jpg, png, gif類型的圖像.
http://www.eqytg.org/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" http://www.eqytg.org/pubapi/uploadImg/did/449/inputid/844
Note:需要在HTTP Header中增加API-Key來授權寫入操作, 支持一次傳送一幅圖像數據;
Note:目前限定相鄰圖像數據上傳間隔須大于等于10s;
Note:圖片大小不大于100K;
Note:圖片格式jpg、png、gif。