Get item group list

Xsolla Developers

A Cuenta del editor

Get item group listClient-side

get/v2/project/{project_id}/items/groups

Gets an item group list for building a catalog.

Request

path Parameters

project_id

required

integer

ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.

Example: 44056

query Parameters

promo_code

string [ 1 .. 128 ] characters

Código único que distingue entre mayúsculas y minúsculas. Contiene letras y números.

Example: promo_code=WINTER2021

Responses

200

La lista de grupos se recibió correctamente.

Request samples

curl -i -X GET \
  'https://store.xsolla.com/api/v2/project/{project_id}/items/groups?promo_code=WINTER2021'

Response samples

application/json

{"groups": [{"children": [ ],
"description": "Accessory",
"external_id": "accessory",
"image_url": null,
"level": 0,
"name": "Accessory",
"order": 1,
"parent_external_id": null
},
{"children": [ ],
"description": "Background",
"external_id": "background",
"image_url": null,
"level": 0,
"name": "Background",
"order": 1,
"parent_external_id": null
},
{"children": [ ],
"description": "Hair",
"external_id": "hair",
"image_url": null,
"level": 0,
"name": "Hair",
"order": 1,
"parent_external_id": null
},
{"children": [ ],
"description": "Outfit",
"external_id": "outfit",
"image_url": null,
"level": 0,
"name": "Outfit",
"order": 1,
"parent_external_id": null
},
{"children": [ ],
"description": "Body",
"external_id": "body",
"image_url": null,
"level": 0,
"name": "Body",
"order": 1,
"parent_external_id": null
},
{"children": [ ],
"description": "Body",
"external_id": "delete_group",
"image_url": null,
"level": 0,
"name": "Body",
"order": 1,
"parent_external_id": null
},
{"children": [{"children": [ ],
"description": "Group description",
"external_id": "test_group_secure",
"image_url": "http://static.xsolla.com/img/xsolla-logo2.png",
"level": 1,
"name": "Test group secure",
"order": 5,
"parent_external_id": "very_cool_group"
}
],
"description": "Very cool group",
"external_id": "very_cool_group",
"image_url": null,
"level": 0,
"name": "Very cool group",
"order": 1,
"parent_external_id": null
},
{"children": [{"children": [ ],
"description": "Group description",
"external_id": "test_group_split",
"image_url": "http://static.xsolla.com/img/xsolla-logo2.png",
"level": 1,
"name": "Test group secure",
"order": 1,
"parent_external_id": "test_group_secure"
}
],
"description": "Group description",
"external_id": "test_group_secure",
"image_url": "http://static.xsolla.com/img/xsolla-logo2.png",
"level": 0,
"name": "Test group secure",
"order": 1,
"parent_external_id": null
}
]
}