Consultar lista de Categorias

Nesta seção indicaremos como realizar a consulta na lista de categorias da Americanas.

Ao consultar a lista de Categorias, será possível consultar o ID de uma determinada e assim incluí-lo no JSON de produtos.

GET - Consulta lista de categorias

https://omnik.skyhub.com.br/categories

Request headers:

Key
Value

X-User-Email

email_de_usuario

X-Api-Key

token_de_integracao de sua conta SkyHub

X-Accountmanager-key

token_account único de cada Plataforma/ERP

Accept

application/json

Content-Type

application/json

Estrutura de resposta:

{
  "total": 0,
  "limit": 0,
  "offset": "0",
  "sort": "string",
  "values": [
    {
      "id": "string",
      "tenant": "string",
      "operator": "string",
      "createDate": "1970-01-01T00:00:00.000000",
      "lastUpdate": "1970-01-01T00:00:00.000000",
      "channel": "string",
      "eanRequired": "boolean",
      "account": null,
      "lastEvent": null,
      "categoryData": {
        "tag": "string",
        "id": "string",
        "name": "string",
        "id1": "string",
        "name1": "string"
      },
      "attributes": [
        {
          "marketplace": "string",
          "name": "string",
          "nameId": "string",
          "value": "string",
          "valueId": "string",
          "group": "string",
          "grupId": "string",
          "type": "string",
          "typeId": "string",
          "descriptionValue": "string",
          "toSKU": "boolean",
          "variant": "boolean",
          "binary": "boolean",
          "active": "boolean",
          "required": "boolean"
        }
      ]
    }
  ]
}

Example request:

curl --location -g --request GET 'https://omnik.skyhub.com.br/categories?limit=10&offset=2' \
--header 'X-User-Email: email_de_usuario' \
--header 'X-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'

Response esperado:

200 [Success] - OK: Haverá um response body com a lista de categorias:

{
  "total": 1000,
  "limit": 10,
  "offset": 2,
  "values": [
    {
      "tenant": "TALD00776574000660",
      "operator": "TALD00776574000660",
      "account": null,
      "createDate": "2025-01-01T08:42:00.627000",
      "lastUpdate": "2025-01-01T08:42:41.454000",
      "lastEvent": null,
      "id": "3",
      "channel": "TALD00776574000660",
      "eanRequired": false,
      "categoryData": {
        "tag": "x-x-x",
        "id": "x",
        "name": "Nome",
        "id1": "x",
        "name1": "Nome 1",
        "id2": "x",
        "name2": "Nome 2",
        "id3": "x",
        "name3": "Nome 3"
      },
      "attributes": [
        {
          "marketplace": "TALD00776574000660",
          "name": "x",
          "nameId": "x",
          "value": "",
          "valueId": "",
          "group": "Grupo",
          "grupId": "x",
          "type": "Texto",
          "typeId": "1",
          "descriptionValue": "",
          "toSKU": false,
          "variant": false,
          "binary": false,
          "active": true,
          "required": false
        }
      ]
    }
  ]
}

Last updated