GetSbisObject (API3) — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
 
(не показана 1 промежуточная версия этого же участника)
Строка 34: Строка 34:
  
 
==Результат==
 
==Результат==
Метод возвращаем массив структур API3 объектов. Если объект не получен в следствии ошибки в массиве будет присутствовать описание ошибки.
+
Метод возвращает массив структур API3 объектов.  
Структуру API3 объекта с описание обязательных и не обязательных полей можно посмотреть в [[:Категория:SBIS API3 Объект |соответствующем разделе]].
 
  
 +
Если объект не получен в следствие ошибки, в массиве будет присутствовать описание ошибки.
 
Пример результата для объекта Склад:
 
Пример результата для объекта Склад:
 
<source lang="json">
 
<source lang="json">
Строка 56: Строка 56:
 
     }
 
     }
 
]
 
]
 +
</source>
  
 +
В случае ошибки (не ошибки получения объекта, указанной выше), метод возвращает словарь.
 +
<source lang="json">
 +
result: {
 +
    error: {
 +
        action: "API3.GetSbisObject",
 +
        code: 100,
 +
        detail: "",
 +
        message: "Выгрузка данного типа объекта не поддерживается",
 +
        stack: [...]
 +
    }
 +
}
 +
</source>
  
</source>
+
Структуру API3 объекта с описание обязательных и не обязательных полей можно посмотреть в [[:Категория:SBIS API3 Объект |соответствующем разделе]].
  
 
[[Категория:SBIS API3 Метод]]
 
[[Категория:SBIS API3 Метод]]

Текущая версия на 14:28, 6 декабря 2024

Полное имя метода: API3.GetSbisObject

Описание

Метод получает массив API3 структур объектов СБИС по их типу и списку идентификаторов.

Алгоритм

1. Перебираем список идентификаторов объекта.

2. Получаем данные объекта со СБИС по идентификатору и формируем структуру API3 объекта.

3. Добавляем структуру объекта в массив.

4. Если во время получения объекта возникла ошибка она будет добавлена в массив с указанием идентификатора объекта.

Параметры

  • Type – тип объекта (строка)
  • IdList - Массив идентификаторов (массив строк)

Пример запроса для объекта Склад:

requirejs(['Types/source'], function(blo) {
    blo = blo.SbisService;
    new blo({
        endpoint: {
            contract: 'API3',
            address: '/service/'
        }
    }).call('GetSbisObject', {
        'Type': 'Склад',
        'IdList': ['11234', '11235']
    })
});

Результат

Метод возвращает массив структур API3 объектов.

Если объект не получен в следствие ошибки, в массиве будет присутствовать описание ошибки. Пример результата для объекта Склад:

[
    {
        "ИдСБИС": "11234",
        "ИмяСБИС": "Склад",
        "Название": "Склад на Витебской",
    },
    {
        "ИдСБИС": "11235",
        "error": {
            "message": "Ошибка чтения объекта.",
            "code": "100",
            "detail": "Ошибка чтения объекта. Возможно он был удален.",
            "action": "Склад.get_sbis_object",
            "stack": []
        }
    }
]

В случае ошибки (не ошибки получения объекта, указанной выше), метод возвращает словарь.

result: {
    error: {
        action: "API3.GetSbisObject",
        code: 100,
        detail: "",
        message: "Выгрузка данного типа объекта не поддерживается",
        stack: [...]
    }
}

Структуру API3 объекта с описание обязательных и не обязательных полей можно посмотреть в соответствующем разделе.