# Obtener lista de grupos de artículos

Recupera una lista de grupos de artículos para crear un catálogo sin paginación.

Nota:El uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado debe transmitir el JWT del usuario en el encabezado Authorization.

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

## Path parameters:

  - `project_id` (integer, required)
    ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto y en la barra de direcciones del navegador cuando se trabaja en un proyecto. La URL tiene el siguiente formato: https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `locale` (string)
    Idioma de respuesta. Código de idioma de dos letras minúsculas según la norma ISO 639-1. (p. ej., en). Los códigos de configuración regional de cinco caracteres (p. ej., en-US) se admiten en campos de localización como name y description, pero se normalizan como códigos de dos letras en las respuestas. Puede consultar la lista completa de idiomas admitidos en la documentación.

  - `with_geo` (boolean)
    Si se debe devolver o no la información sobre la configuración regional y del país del usuario en los encabezados de la respuesta. Si se establece como true, la respuesta incluye los encabezados X-User-Locale-Code y 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)
    ID externo del grupo.
    Example: "weapons"

  - `groups.name` (string)
    Nombre del grupo.
    Example: "Weapons"

  - `groups.description` (string)
    Descripción del grupo.
    Example: "All weapons available in the game"

  - `groups.image_url` (string,null)
    URL de la imagen.

  - `groups.order` (integer)
    Define el orden de disposición.
    Example: 1

  - `groups.level` (integer)
    Nivel de anidamiento del grupo.

  - `groups.children` (array)
    Grupos secundarios.
    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)
    ID externo del grupo.
    Example: "background"

  - `groups.children.name` (string)
    Nombre del grupo.
    Example: "Background"

  - `groups.children.description` (string)
    Descripción del grupo.
    Example: "Background description"

  - `groups.children.image_url` (string,null)
    URL de la imagen del grupo.

  - `groups.children.order` (integer)
    Define el orden de disposición.
    Example: 1

  - `groups.children.level` (integer)
    Nivel de anidamiento del grupo.
    Example: 1

  - `groups.children.children` (array)
    Grupos secundarios.
    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)
    ID externo del grupo.
    Example: "accessory"

  - `groups.children.children.name` (string)
    Nombre del grupo.
    Example: "Accessory"

  - `groups.children.children.description` (string)
    Descripción del grupo.
    Example: "Accessory"

  - `groups.children.children.image_url` (string,null)
    URL de la imagen.

  - `groups.children.children.order` (integer)
    Define el orden de disposición.
    Example: 1

  - `groups.children.children.level` (integer)
    Nivel de anidamiento del grupo.
    Example: 2

  - `groups.children.children.children` (array)
    Grupos secundarios.
    Example: []

  - `groups.children.children.parent_external_id` (string,null)
    ID externo del grupo primario.
    Example: "background"

  - `groups.children.parent_external_id` (string,null)
    ID externo del grupo primario.
    Example: "weapons"

  - `groups.parent_external_id` (string,null)
    ID externo del grupo primario.