products.categories
Categorias ativas com produtos ativos, contagem por categoria e ordenação alfabética.
Exemplos seguros e fictícios. O domínio
example.invalid e a credencial demonstrativa abaixo não funcionam. Use o token real somente no servidor da sua integração e nunca o inclua em páginas públicas.Parâmetros
Este método não exige parâmetros no corpo da requisição.
Exemplos fictícios
Os exemplos documentam o formato; eles não executam nenhuma operação.
Requisição
cURL demonstrativo
curl --request POST \
'https://example.invalid/api/v1/CREDENCIAL_FICTICIA_SEM_VALOR/products.categories' \
--header 'Content-Type: application/json' \
--data '{}'Corpo JSON
{}Resposta HTTP 200
{
"ok": true,
"method": "products.categories",
"result": {
"categorias": [
{
"categoria_id": "33333333-3333-4333-8333-333333333333",
"categoria": "Categoria exemplo",
"total": 1
}
]
}
}Erros
| HTTP | Código | Condição |
|---|---|---|
| 403 | TOKEN_NO_COMPANY | Token sem empresa associada. |
Consulte também os erros globais e limites.
Observações
- Com Tiny conectado, considera apenas produtos de fonte tiny.
- Use o campo categoria, não categoria_id, no filtro de products.list/search.