edit.md

Device Edit

Description

Use HTTP PUT to request for a specific device edit

Request URL

http://api.mediatek.com/api/v1.0/devices/{device_id}

Action

HTTP PUT

Parameters

Header

apiKey:YOUR_API_KEY_HERE Content-Type:application/json

Body

Data Format: JSON

The body construct should be in JSON format with the following fields:

Field Name	Mandatory	Type	Description
title	No	String	Device name
desc	No	String	Device description
tags	No	Array	Device tags
location	No	JSON	latitude: float , longitude: float

###Example:

Sample JSON

{
  "title": "test01",
  "desc": "device for testing",
  "tags": [
    "test01 lab",
    "temperature"
  ],
  "location": {
    "latitude": "24.940225",
    "longitude": "121.501913"
  }
}

Response

Response Code

200

Response Header

Content-Type:application/json

Response Body

Data Format: JSON

The response body will construct in JSON format with the following fields:

Field Name	Type	Description
results	Strings	resturns "success" only

Example:

Request URL

http://api.mediatek.com/api/v1.0/devices/100000012

Response Body

{
  "results": "success"
}

Error Response

When error is incurred, the response code will be non-200 and the response body will construct in JSON format with the following fields:

Field Name	Type	Description
code	Integer	Error Code
url	String	url to API Error detail page
description	String	Error Description

**Example: **

{
  "results": {
    "code": 1002,
    "url": "http:\\mcs.mediatek.com\api_errorcode?code=1002",
    "description": "You do not have access right to this API"
  }
}