ГОСТ Р 56947—2016
12.1.2 Формат НТТР-ответа
Выходная спецификация или выходные аргументы, например массив аргументов ArgumentArray,
могут быть включены в HTTP-запрос или в ответ на HTTP-запрос. Выходной формат может быть в фор
матах «XML», «HTML» или «text» («текст»).
Формат ответа определяется аргументом «format» («формат») HTTP-сообщения. Ответы должны
быть отформатированы в соответствии с правилами, указанными в настоящем разделе.
12.1.2.1 Формат XML ответа
Если указан формат XML. то ответ должен быть отформатирован в соответствии с XML-
схемой, связанной с данной командой. Форматирование, указанное в командах, опирается на
библиотеку типов, основанную на типах данных, определенных в разделе 4. Полное описание
XML-схемы доступно по адресу
http://grouper.ieee.Org/groups/1451/0/1451HTTPAPI/
. Имя файла
SmartTransducerHTTPResponse.xsd.
12.1.2.2 Формат HTML ответа
Если указан формат HTML, то ответ должен быть отформатирован как действительная веб
страница в формате HTTP 1.1. Форматирование веб-страницы и верстка не приводятся. Тем не менее
все параметры, которые определяют ответы, должны использовать формат тегированных данных, тег
которых совпадает с идентификатором возвращаемого ответа, указанным в возвращенном формате
команды.
12.1.2.3 Текстовый ответ
Текстовый ответ должен быть представлен в формате, в котором возвращаются отдельные
параметры, и должен быть ограничен управляющим символом CR/LF (возврат каретки/перевод
строки) (ASCII 13,10). Значения должны быть возвращены в порядке, установленном семантикой
команды.
Если в качестве ответа возвращается массив, то каждое значение должно быть отделено запятой
и весь массив должен завершаться управляющим символом CR/LF (возврат каретки/перевод строки).
Многомерный массив должен быть возвращен с крайним правым порядковым числительным, которое
индексируется в первую очередь. Управляющий символ CR/LF (возврат каретки/перевод строки) дол
жен быть возвращен после возвращения каждого полного набора крайних правых индексов. Данный
формат обычно называется форматом «csv».
Целые числа должны быть возвращены в формате
<SignxV alue>,
где
<Sign>=
«♦» или «-», а
<Value>
определяется как строка, содержащая один или более символов, значение которых от «О»до «9».
Числа с плавающей точкой должны быть возвращены в экспоненциальном представлении в фор
мате
<Sign><Leading d i g i t > . <Mantissa>E<Sigr.XExponer.t>,
где
<Sign>
— определено выше;
<L eadin gd igit>
— одиночный символ, как определено для
<Value>
(см. выше);
<M antissa>
и
<Exponent>
—аналогично
<Value>
(см. выше).
Любое возвращаемое значение, которое представляет собой нумерацию, должно возвращать
свое порядковое значение в виде целого числа.
Любое возвращаемое значение, которое представляет собой строку, должно возвращать данную
строку, заключенную в кавычки ("<string>"). Встроенные кавычки должны быть возвращены в качестве
удвоенных кавычек ("").
12.2 API обнаружения
API обнаружения предназначен для выявления всех доступных ИМП и каналов преобразователей
(преобразователей).
12.2.1 Интерфейс «TlMDiscovery» («Обнаружение ИМП»)
Данный API поддерживает выдачу отчетов обо всех «timlds» всех ИМП, подключенных к данному
СПП (хосту). Данный API соответствует
A rgs: :U ln tl6 report Tims О
. описанному в 10.1.2.
Путь «Path»: 1451/Discovery/TIMDiscovery.
Метод «GET» («Получить»): находит «timlds» всех ИМП. подключенных к СПП (хосту), и возвра
щает «timlds» в формате XML-документа или формате ASCII.
12.2.1.1 Входные параметры
Следующий параметр должен поставляться вместе с вызовом данного API:
S trin g responseForm at
- указывает формат ответа, как это определено в 12.1.2.
1 8 9