Справочник "Наименования грузов"

Описание

Получение наименований грузов.

Структура URL

GET /v2/references/cargo

Список параметров

Название	Описание	Тип передачи параметра	Обязательный(+)/По умолчанию(значение)
language	Язык локализации. Описание использования.	Query string parameter	ru
ids	Дополнительные параметры фильтрации.	Query string parameter
query	Текст для поиска.	Query string parameter
limit	Желаемое количество ответов, максимум 100.	Query string parameter	10

Особенности формирования запроса

В запросе должен быть обязательно указан параметр ids (?ids=2,4,7) или параметр query (?query=test)

Результат

Массив структур "Базовый элемент справочника".

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

Использование параметра ids

ids

curl -X GET -H "Accept: application/json" -H "Authorization: 3WQ1EQ465C4005000130" "https://api.lardi-trans.com/v2/references/cargo?ids=7,10,18"

[
    {
        "id": 7,
        "name": "абрикосы"
    },
    {
        "id": 10,
        "name": "абразивный порошок"
    },
    {
        "id": 18,
        "name": "автохимия"
    }
]

Использование параметра query

query

Запрос на англ. языке (no URL-encoding, query=aprico)

curl -X GET -H "Accept: application/json" -H "Authorization: 3WQ1EQ465C4005000130" "https://api.lardi-trans.com/v2/references/cargo?query=aprico&language=en"

[
    {
        "id": 12,
        "name": "apricot in boxes"
    },
    {
        "id": 6,
        "name": "apricots in boxes"
    },
    {
        "id": 7,
        "name": "apricots"
    }
]

Запрос на укр. языке (URL-encoded, query=абрик)

curl -X GET -H "Accept: application/json" -H "Authorization: 3WQ1EQ465C4005000130" "https://api.lardi-trans.com/v2/references/cargo?query=%D0%B0%D0%B1%D1%80%D0%B8%D0%BA&language=uk"

[
    {
        "id": 12,
        "name": "абрикос в ящиках"
    },
    {
        "id": 6,
        "name": "абрикоси в ящиках"
    },
    {
        "id": 7,
        "name": "абрикоси"
    }
]

Запрос на укр. языке (URL-encoded, query=абр, limit=5)

curl -X GET -H "Accept: application/json" -H "Authorization: 3WQ1EQ465C4005000130" "https://api.lardi-trans.com/v2/references/cargo?query=%D0%B0%D0%B1%D1%80&limit=5&language=uk"

[
    {
        "id": 11,
        "name": "абразив"
    },
    {
        "id": 5,
        "name": "абразиви"
    },
    {
        "id": 8,
        "name": "абразиви в біг-бегах"
    },
    {
        "id": 9,
        "name": "абразиви навалом"
    },
    {
        "id": 10,
        "name": "абразивний порошок"
    }
]