# Получение списка групп товаров

Возвращает список групп товаров для построения каталога без пагинации.

NoteIn general, the use of catalog of items is available without authorization. Only authorized users can get a personalized catalog.

Endpoint: GET /v2/project/{project_id}/items/groups
Version: 2.0.0

## Path parameters:

  - `project_id` (integer, required)
    ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта, а также в адресной строке браузера при работе с проектом. URL-адрес имеет следующий формат: https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `locale` (string)
    Язык ответа. Двухбуквенный код языка в нижнем регистре по стандарту ISO 639-1 (например, en). Коды локали из пяти символов (например, en-US) поддерживаются в полях локализации (например, name, description), но в ответах приводятся к двухбуквенному формату. Полный список поддерживаемых языков приведен в документации.

  - `with_geo` (boolean)
    Возвращать ли информацию о локали и стране пользователя в заголовках ответа. Если установлено значение true, ответ включает заголовки X-User-Locale-Code и X-User-Country-Code.

## Response 200 fields (application/json):

  - `groups` (array)
    Example: [{"external_id":"weapons","name":"Weapons","description":"All weapons available in the game","image_url":null,"order":1},{"external_id":"group_external_id","name":"Super","description":"Super description","image_url":null,"order":1}]

  - `groups.external_id` (string)
    External ID группы.
    Example: "weapons"

  - `groups.name` (string)
    Название группы.
    Example: "Weapons"

  - `groups.description` (string)
    Описание группы.
    Example: "All weapons available in the game"

  - `groups.image_url` (string,null)
    URL-адрес изображения.

  - `groups.order` (integer)
    Определяет порядок расположения.
    Example: 1

  - `groups.level` (integer)
    Уровень вложенности группы.

  - `groups.children` (array)
    Дочерние группы.
    Example: [{"external_id":"background","name":"Background","description":"Background description","image_url":null,"order":1,"level":1,"children":[{"external_id":"accessory","name":"Accessory","description":"Accessory","image_url":null,"order":1,"level":2,"children":[],"parent_external_id":"background"}],"parent_external_id":"weapons"}]

  - `groups.children.external_id` (string)
    External ID группы.
    Example: "background"

  - `groups.children.name` (string)
    Название группы.
    Example: "Background"

  - `groups.children.description` (string)
    Описание группы.
    Example: "Background description"

  - `groups.children.image_url` (string,null)
    URL-адрес изображения группы.

  - `groups.children.order` (integer)
    Определяет порядок расположения.
    Example: 1

  - `groups.children.level` (integer)
    Уровень вложенности группы.
    Example: 1

  - `groups.children.children` (array)
    Дочерние группы.
    Example: [{"external_id":"accessory","name":"Accessory","description":"Accessory","image_url":null,"order":1,"level":2,"children":[],"parent_external_id":"background"}]

  - `groups.children.children.external_id` (string)
    External ID группы.
    Example: "accessory"

  - `groups.children.children.name` (string)
    Название группы.
    Example: "Accessory"

  - `groups.children.children.description` (string)
    Описание группы.
    Example: "Accessory"

  - `groups.children.children.image_url` (string,null)
    URL-адрес изображения.

  - `groups.children.children.order` (integer)
    Определяет порядок расположения.
    Example: 1

  - `groups.children.children.level` (integer)
    Уровень вложенности группы.
    Example: 2

  - `groups.children.children.children` (array)
    Дочерние группы.
    Example: []

  - `groups.children.children.parent_external_id` (string,null)
    Путь к каталогу (родительская папка группы).
    Example: "background"

  - `groups.children.parent_external_id` (string,null)
    Путь к каталогу (родительская папка группы).
    Example: "weapons"

  - `groups.parent_external_id` (string,null)
    Путь к каталогу (родительская папка группы).