Перейти к содержанию

Дополнительная фильтрация по идентификаторам

Описание

При получении справочников можно использовать дополнительный параметр ids, чтобы в массиве ответа остались только элементы справочника, чьи идентификаторы были упомянуты в строке запроса.

Примечания:

Структура URL

1
2
3
4
5
6
7
8
GET /v2/path/to/some/reference?ids=1&ids=2&ids=5
# или
GET /v2/path/to/some/reference?ids=1,2,5

# для справочника стран
GET /v2/references/countries?signs=TZ&signs=JP
# или
GET /v2/references/countries?signs=TZ,JP

Примеры запроса и ответа.

Для справочника "Области"

Запрос

1
curl -X GET -H "Accept: application/json" -H "Authorization: 3WQ1EQ465C4005000130" "https://api.lardi-trans.com/v2/references/areas?ids=16,17,19" 

Ответ

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
[
    {
        "id": 16,
        "name": "Волынская обл.",
        "countrySign": "UA",
        "regionId": 4
    },
    {
        "id": 17,
        "name": "Днепропетровская обл.",
        "countrySign": "UA",
        "regionId": 2
    },
    {
        "id": 19,
        "name": "Житомирская обл.",
        "countrySign": "UA",
        "regionId": 6
    }
]
Для справочника "Страны"

Запрос

1
curl -X GET -H "Accept: application/json" -H "Authorization: 3WQ1EQ465C4005000130" "https://api.lardi-trans.com/v2/references/countries?signs=JP,TZ" 

Ответ

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
[
    {
        "sign": "TZ",
        "name": "Танзания"
    },
    {
        "sign": "JP",
        "name": "Япония"
    }
]