Rest Resources For Adam; Analog Input; Introduction - Advantech ADAM-6217 User Manual

C.1

Introduction

REpresentational State Transfer (REST) is a design style of software architecture for
Web application behaves and services including image indication, resource request
and response and message delivery. It can be developed compatible with popular
protocols or standards like HTTP, URI, XML, HTML. With the advantage of scalability,
simplicity and performance, it's already adopted in Web service by Amazon, Yahoo.
The Web service of ADAM-6200 is developed based on HTML5 language, if user
need to integrate this into other Web services, the following information/command list
should be referred for implementation.
C.2

REST Resources for ADAM

C.2.1

Analog Input

C.2.1.1 GET /analoginput/(all|{id})/value
Request
Response
Remarks
ADAM-6200 User Manual
The content‐type will be 'application/x‐www‐form‐urlencoded'.
{id} : is the AI channel ID starting from 0
Examples:
Use the following URI to get the AI‐0 value.
http://10.0.0.1/analoginput/0/value
Use the following URI to get the all AI values.
http://10.0.0.1/analoginput/all/value
The content-type will be 'text/xml'
If result is OK, the content will look like below
<?xml version="1.0" ?>
<ADAM-6217 status="OK">
<AI>
<ID>0</ID>
<
VALUE>FFFF</VALUE>
</AI>
</ADAM-6217>
If result is failed , the content will look like below
<?xml version="1.0" ?>
<ADAM‐6217 status="{error}">
</ADAM-6217>
{error} : The error message.
If the {id} is out of range, the response will return HTTP status code 501
(Not implemented)
180