Novidades da API REST
Resumo das evoluções recentes já incorporadas à API e refletidas nesta documentação.
Changelog
Hardening
2026
Melhorias recentes da API
Principais entregas que reforçaram a estabilidade, a segurança e a previsibilidade da API.
- Maior robustez no processamento de estoque e preços em fila.
- Validação mais clara para campos, atributos e valores inválidos no update de produto.
- Semântica melhorada para
partial_success. - Reindex mais enxuto e seletivo.
- Hardening de OAuth, auditoria e endpoints operacionais.
Novas capacidades já disponíveis
OAuth seguroNovos
client_secret com armazenamento protegido e mascaramento no admin.Update parcial transparenteResposta clara com
invalid_fields, invalid_attributes e invalid_attribute_values.Operação mais previsívelFila robusta, claim atômico e reindex seletivo.
Evoluções no endpoint de produtos
Três melhorias recentes tornam o GET /api2/products mais determinístico em multi-store e mais eficiente para sincronizações em lote.
store_id opcionalSeleção explícita da store em ambientes multi-store.Metadados de paginação
total, last_page e has_next via include_pagination=1.limit configurávelPadrão 20, máximo 200, inválidos normalizados.Ver em detalhe
Documentação técnica completa na página de Produtos.
Evoluções no endpoint de categorias Novo
O GET /api2/category agora suporta listagem paginada com as mesmas garantias já disponíveis no endpoint de produtos. É possível percorrer toda a árvore sem precisar consultar uma categoria por vez.
Listagem completa
GET /api2/category retorna todas as categorias com paginação previsível.limit configurávelPadrão 20, máximo 200, inválidos normalizados para o padrão.store_id opcionalContexto multi-store explícito e determinístico.Metadados opcionais
total, last_page e has_next via include_pagination=1.Busca por ID
?id=61 preservado para consulta individual.Paginação determinística
?page=N percorre a árvore com segurança.Ver em detalhe
Documentação técnica completa na página de Categorias.