Подразделы
Call API представляет собой набор http-команд, event-ов, использую которые можно управлять вызовами в рамках ECSS-10.
Call API поддерживает 2 типа контента:
- XML (см. схемы приведенные в разделе "XSD файлы")
- DOM закодированный в JSON.
Предположим, XML имеет следующую обобщенную структуру:
<ELEMENT_1 ATTRIBUTE_1=VALUE_1, ... ATTRIBUTE_N=VALUE_N> ... CONTENT </ELEMENT_1> ... <ELEMENT_N ...> ... CONTENT </ELEMENT_N>
CONTENT рекурсивно определяет такую же структуру для всех вложенных узлов.
Данная структура представляется в виде JSON следующего вида:
[
{
"_name":"ELEMENT_1",
"_attributes": {"ATTRIBUTE_1":"VALUE_1", ... "ATTRIBUTE_N":"VALUE_N"},
"_content": CONTENT
},
...
{
"_name":"ELEMENT_N",
"_content": CONTENT
}
]
Пример
Возьмем следующую структуру xml:
<a> <b x="test"> </a> <c/>
Она будет преобразована в следующую структуру JSON:
[
{
"_name":"a",
"_content": [
{
"_name":"b",
"_attributes":{"x":"test"}
}
]
},
{
"_name":"c"
}
]
Ограничения
Со стороны JSON поддерживается только значения типа "строка". Это значит, что если по API подразумевается передача численного аргумента, или аргумента типа boolean, оно должно быть представлено в виде строки:> {
> {
> "value":42
> }
>
Должно выглядеть следующим образом:
> {
> "value":"42"
> }
>
- Cо стороны XML не поддерживаются неймспейсы и текстовый контент.