Detalhes

Descrição dos campos

CampoRequeridoÚnicoTipo do campoMax CaracteresDescrição
idInt4-ID da categoria
titleVarchar500Título
slugVarchar2000Slug (url), caso vazio o sistema gera automaticamente
activeBoolean1Indica se esta ativo default = true
parentInt4-ID da categoria pai
reference_codeVarchar64Código de referência
detailsText-Descrição da categoria detalhada
meta_titleVarchar255Título da categoria para SEO
meta_descriptionVarchar100Descrição da categoria para SEO
inherit_templateBoolean1Herdar template da categoria pai
meta_keywordsVarchar255Keywords da categoria para SEO separadas por “,”
global_codeVarchar500Código da categoria Global (Google)

Filtros via Query Parameters

ParameterDescription
idFiltro por ID da categoria
titleFiltro por título da Categoria
add_date__lteFiltro por data de criação menor ou igual
add_date__gteFiltro por data de criação maior ou igual
change_date__lteFiltro por data de alteração menor ou igual
change_date__gteFiltro por data de alteração maior ou igual
reference_codeFiltro por código de referência ou código da grade no ERP
reference_code__isnullFiltro por código de referência no ERP nulo

Exemplos

using RestSharp;
var client = new RestClient("https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/");

var request = new RestRequest("/categories/");
request.Method = Method.GET;
request.AddHeader("Authorization", "Token " + API_KEY);

var response = client.Execute(request);
curl "https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/"
  -H "Authorization: Token API_KEY"
import requests

r = requests.get('https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/', headers={
  'Authorization': 'Token %s' % API_KEY
})

print r.status_code
print r.json()

O comando acima retornar um JSON conforme estrutura abaixo:

{
    "url":"https://api.convertize.com.br/{ENVIRONMENT}/api/1.0/categories/74/",
    "id": 27,
    "parent": null,
    "_order": 18,
    "title": "Óculos de Grau",
    "slug": "oculos-de-grau",
    "reference_code": null,
    "active": true,
    "add_date": "2022-02-28T10:12:03.508429",
    "change_date": "2022-02-28T10:28:55.300301",
    "meta_title": null,
    "meta_description": "",
    "meta_keywords": null,
    "inherit_template": false,
    "for_gift_list": false,
    "global_code": "524",
    "details": "",
    "lft": 1,
    "rght": 8,
    "tree_id": 5,
    "level": 0
}

📘

O campo global_code é categoria de taxonomia do Google, para saber mais acesse o link [google_product_category]