導航中心

API文檔 (版本1.0,版本 v1.1 測試中)

圖像數據

圖像信息是由key和value組成的鍵值對, 圖像內容則是二進制圖像文件.

API列表
/v1.0/device/<device_id>/sensor/<sensor_id>/photos上傳圖像在線調試
/v1.0/device/<device_id>/sensor/<sensor_id>/photo/info/<key>獲取圖像(信息)在線調試
/v1.0/device/<device_id>/sensor/<sensor_id>/photo/content/<key>獲取圖像(內容)在線調試

上傳圖像

對該URL的一個HTTP POST請求會為指定的圖像傳感器上傳一幅新的圖像, 使用此API來為圖像傳感器存儲圖像數據, 目前只支持上傳jpg, png, gif類型的圖像.

URL

http://api.yeelink.net/v1.0/device/<device_id>/sensor/<sensor_id>/photos

請求參數

參數名 必需 類型 說明
device_id true string 設備ID
sensor_id true string 傳感器ID

數據格式

binary

注意:此處格式與數值型傳感器等不同,不再使用JSON格式,而是直接上傳圖片的原始內容

Method

POST

返回值

HTTP Headers only

訪問授權

需要在HTTP Header中增加API Key來授權寫入操作, 具體請參照API Key.支持一次傳送一幅圖像數據.

請求實例

  • CURL
  • curl --request POST --data-binary @datafile.jpg --header "U-ApiKey: YOUR_API_KEY_HERE" 
       http://api.yeelink.net/v1.0/device/12/sensor/3/photos

    Note:需要在HTTP Header中增加API Key來授權寫入操作, 具體請參照API Key. 支持一次傳送一幅圖像數據.

    Note:目前限定相鄰圖像數據上傳間隔須大于等于10s, 過于頻繁的請求會收到406 Response.

獲取圖像(信息)

對該URL的請求返回指定key的圖像信息, 若未指定key, 則返回該sensor的最新圖像信息.

URL

http://api.yeelink.net/v1.0/device/<device_id>/sensor/<sensor_id>/photo/info/<key>

請求參數

參數名 必需 類型 說明
device_id true string 設備ID
sensor_id true string 傳感器ID
key false string 圖片Key

Method

GET

返回值

圖像信息

數據格式

JSON

返回數據格式說明

Note:指定Key

參數名 必需 類型 說明
value true json size, width, height, type
{
	"value":{"size": 45, "width": 240, "height": 320, "type": "jpg"
	}
}

其中size單位為kb.

Note:未指定Key

參數名 必需 類型 說明
timestamp true string key
value true json size, width, height, type
{
  "timestamp":"2012-03-15T16:13:14",
  "value":{"size": 45, "width": 240, "height": 320, "type": "jpg"}
}

請求授權

需要在HTTP Header中增加API Key來授權GET操作, 具體請參照API Key.

請求實例

  • CURL
  • Note:指定Key

    curl --request GET --header "U-ApiKey: YOUR_API_KEY_HERE"
      http://api.yeelink.net/v1.0/device/12/sensor/3/photo/info/2012-03-15T16:13:14

    Note:<key>為所要獲取圖像的時間戳(ISO 8601格式).

    Note:未指定Key

    curl --request GET --header "U-ApiKey: YOUR_API_KEY_HERE" 
    	http://api.yeelink.net/v1.0/device/12/sensor/3/photo/info

獲取圖像(內容)

對該URL的請求返回指定key的圖像內容, 若未指定key, 則返回該sensor的最新圖像內容.

URL

http://api.yeelink.net/v1.0/device/<device_id>/sensor/<sensor_id>/photo/content/<key>

請求參數

參數名 必需 類型 說明
device_id true string 設備ID
sensor_id true string 傳感器ID
key false string 圖片Key

數據格式

binary

格式說明

參數名 必需 類型 說明
PhotoBinaryData true binary 圖像內容
<PhotoBinaryData>

Method

GET

返回值

圖像內容

訪問授權

需要在HTTP Header中增加API Key來授權GET操作, 具體請參照API Key.

請求實例 (運用curl):

  • CURL
  • curl --request GET --header "U-ApiKey: YOUR_API_KEY_HERE"
      http://api.yeelink.net/v1.0/device/12/sensor/3/photo/content/2012-03-15T16:13:14
澳洲幸运8中国体育彩票