Detalhes

Descrição dos campos

Campo	Requerido	Único	Tipo do campo	Max Caracteres	Descrição
id		✅	Int4	-	ID da categoria
title	✅		Varchar	500	Título
slug		✅	Varchar	2000	Slug (url), caso vazio o sistema gera automaticamente
active			Boolean	1	Indica se esta ativo default = true
parent			Int4	-	ID da categoria pai
reference_code			Varchar	64	Código de referência
details			Text	-	Descrição da categoria detalhada
meta_title			Varchar	255	Título da categoria para SEO
meta_description			Varchar	100	Descrição da categoria para SEO
inherit_template			Boolean	1	Herdar template da categoria pai
meta_keywords			Varchar	255	Keywords da categoria para SEO separadas por “,”
global_code			Varchar	500	Código da categoria Global (Google)

Filtros via Query Parameters

Parameter	Description
id	Filtro por ID da categoria
title	Filtro por título da Categoria
add_date__lte	Filtro por data de criação menor ou igual
add_date__gte	Filtro por data de criação maior ou igual
change_date__lte	Filtro por data de alteração menor ou igual
change_date__gte	Filtro por data de alteração maior ou igual
reference_code	Filtro por código de referência ou código da grade no ERP
reference_code__isnull	Filtro 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