Мельница данных  (20.07.2026)
Стандартная структура передачи данных в формате объекта JSON

Стандартная структура данных в формате JSON представляет собой один объект JSON. Поле rows этого объекта представляет собой массив, элементы которого являются объектами, соответствующими записям набора данных. Поля этих объектов соответствуют полям структуры данных и их значениям. Также объект JSON может иметь и другие необязательные поля.

Пример
Пример структуры данных в формате документа JSON: 
01{
02  "handle": "{FDF9EE70-9948-4A99-8233-349C3ADD3CE8}",
03  "eof": 1,
04  "rows":
05    [
06      {
07        "ID":6524,
08        "LastName": "Abrams",
09        "FirstName": "Steaven",
10        "BirthDate": {
11          "year": 1982,
12          "month": 6,
13          "day": 10
14        },
15        "AcademicDegree": "PhD",
16        "ContactList: "856 45 12 46;756 12 45 41",
17        "Photo": "#00000000001506D00BD85C3C"
18      },
19      {
20        "ID": 6525,
21        "LastName": "Adkisson",
22        "FirstName": "Amalia",
23        "BirthDate": {
24          "year": 1979,
25          "month": 8,
26          "day": 4
27        },
28        "AcademicDegree": "Doctor of Arts",
29        "ContactList: null,
30        "Photo": null
31      },
32      {
33        "ID": 6526,
34        "LastName": "Adkisson",
35        "FirstName": "Maria",
36        "BirthDate": {
37          "year": 1980,
38          "month": 9,
39          "day": 5
40        },
41        "AcademicDegree": null,
42        "ContactList: "656 545 12 54",
43        "Photo": null
44      }
45    ]
46}

Поля объекта JSON, представляющие структуру данных:

  • handle (необязательно) - строковый идентификатор структуры данных, который позволяет дальнейшие обращения к ней;
  • eof (необязательно) -  поле может принимать значения "1" или "0". Значение "1" или отсутствие этого поля означает, что набор данных является полным (получен полностью в ответ на запрос), значение "0" означает, что данные получены не полностью; в этом случае можно запрашивать дополнительные данные, используя только значение handle до тех пор, пока в ответе не будет получено значения eof="1". Подробнее: Использование возвращаемого ответа;
  • rows (необязательно) - массив объектов, каждый из которых соответствует одной записи структуры данных.

Объекты массива rows имеют набор полей, каждое из которых соответствует полю структуры данных и его значению. Имя поля совпадает с именем поля структуры данных, и значение поля передает значение поля структуры данных.

В случае, если в ответ на запрос не возвращено ни одной записи, объект JSON не будет иметь полей и будет представлять собой пустой объект JSON {}.