Com o objetivo de melhorar a integração com parceiros, a API do Cosmos agora conta com um novo recurso que permite a consulta de produtos baseada na sua data de atualização.
O que mudou?
Foi criado o endpoint /api/products/by_date, que permite recuperar todos os produtos que sofreram alterações a partir de um dia e hora específicos até o momento atual.
Detalhes Técnicos do Novo Recurso:
• Endpoint: GET /api/products/by_date?date={Data/Hora inicial no formato ISO 8601}.
• Parâmetro Obrigatório: O parâmetro date deve ser enviado obrigatoriamente no formato ISO 8601 (exemplo: 2025-12-20T00:00:00Z).
• Limite de Busca: Para garantir a performance do banco de dados, a consulta é permitida apenas para um intervalo de até 7 dias atrás em relação à data atual.
• Autenticação: O acesso permanece protegido, exigindo o header X-Cosmos-Token válido para a requisição.
Caso a consulta retorne mais de 30 registros, o sistema utiliza paginação. Você pode navegar entre os resultados utilizando o parâmetro page na URL (exemplo: ?date=...&page=2).
Validações Importantes:
• Se a data informada for superior a 7 dias, a API retornará um erro 400 Bad Request informando o limite permitido.
• Se não houver produtos alterados no período informado, o retorno será um status 200 OK com uma lista vazia (products: []).
Esta melhoria visa dar mais agilidade aos processos de sincronização de dados, permitindo que os parceiros identifiquem rapidamente quais itens foram modificados no catálogo.
Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.