Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Признак optional – необязательное поле:



  2. Тип данных поля:



  3. Подсказку по возможным значениям поля (если набор значений ограничен):

    Image Modified

    Info

    Если поле не является обязательным (признак optional), то значением по умолчанию автоматически выбирается первое значение из списка.


  4. Перекрестные ссылки на вложенные типы:



  5. Признак множества значений в параметре, сформированных в массиве:

Форматы примитивных типов

Спецификация формата JSON поддерживает ограниченное количество примитивных типов.

Из них используются:

  • string - текстовая строка, заключенная в двойные кавычки (если строка содержит двойные кавычки, то они должны быть экранированы обратной косой чертой)

    Code Block
    languagejs
    {
        "Cargo": "Продукты питания",
        "CompanyName": "ООО \"Звезда\""
    }


  • number - целое или дробное число (при записи дробного, необходимо использовать разделитель точка)

    Code Block
    languagejs
    {
        "Count": 10,
        "Cost": 123.45
    }


  • boolean - логическое значение

    Code Block
    languagejs
    {
        "IsPublic": true,
        "Disabled": false
    }


Кроме них, модель поддерживает расширенные типы, передаваемые в виде строки:

  • идентификаторы в формате GUID

    Code Block
    languagejs
    {
        "CompanyId": "6cf1227c-f0e4-4247-a0df-42d7da6b30f8",
        "ContactId": "43f68fd8-ba98-449d-a6eb-0a715af1a6b2"
    }


  • дата/время в формате ISO 8601

    Code Block
    languagejs
    {
        "CreateDate": "2022-05-11",
        "StartTime": "2022-05-11T12:30"
    }


    Info

    Обратите внимание, что переданное в API время интерпретируется как локальное время пользователя, от имени которого сделан запрос (данные пользователя указываются при авторизации в системе).

    Не стоит пытаться передавать в API абсолютное время в формате UTC или с явным указанием часового пояса.