Skip to content

Latest commit

 

History

History
42 lines (26 loc) · 2.72 KB

rest_api_v2_ex_get_entities_list.adoc

File metadata and controls

42 lines (26 loc) · 2.72 KB
Raw

Получение списка экземпляров сущности

Предположим, в системе имеется сущность sales$Order, и необходимо получить список экземпляров этой сущности. При этом, необходимо получить не все записи, а 50 записей, начиная с сотой (для отображения третьей странице в каком-либо списке клиентского приложения). Кроме простых атрибутов сущности sales$Order результат должен содержать данные о клиенте (поле customer). Заказы должны быть отсортированы по дате.

Базовый URL для получения списка экземпляров сущности sales$Order:

http://localhost:8080/app/rest/v2/entities/sales$Order

Для выполнения описанных выше условий необходимо задать параметры запроса:

  • view - представление, с которым должны быть загружены сущности. В нашем примере представление order-edit-view содержит ссылку на customer.

  • limit - количество возвращаемых экземпляров.

  • offset - позиция первого извлеченного элемента.

  • sort - имя атрибута сущности, по которому будет произведена сортировка.

OAuth-токен должен быть передан в заголовке запроса Authorization с типом Bearer:

Authorization: Bearer 29bc6b45-83cd-4050-8c7a-2a8a60adf251

В итоге получаем следующий GET http-запрос:

http://localhost:8080/app/rest/v2/entities/sales$Order?view=order-edit-view&limit=50&offset=100&sort=date

В cURL запрос может выглядеть так:

link:../../../../source/rest/rest_api_v2_ex_get_entities_list.txt[role=include]

Ответ будет выглядеть следующим образом:

link:../../../../source/rest/rest-orders-list-response.json[role=include]

Обратите внимание, что для каждой сущности загружаются атрибуты _entityName с именем сущности и _instanceName, содержащий результат вычисления короткого имени для сущности.