Se você fizer uma requisição GET na URL raiz de uma entidade, a API retornará uma lista com todos os registros
cadastrados. Nesse caso, é obrigatório implementar o tratamento de paginação, conforme já explicado no
tópico anterior🔗.
Já as requisições GET utilizando o ID de um registro (ou seja, apontando diretamente para um item específico) retornam apenas aquele único registro. Essa funcionalidade está disponível apenas no ambiente de sandbox, para facilitar a verificação e validação de dados durante a fase de testes.
Após a homologação da sua integração e a liberação do acesso ao ambiente de produção, o uso do GET por ID não será permitido. Essa restrição existe por questões de performance do sistema e para garantir a melhor experiência possível aos usuários da plataforma.
Importante destacar que a API da Mercos é voltada principalmente para operações de cadastro e atualização de dados.
Por esse motivo, o uso do GET em produção está limitado, sendo liberado apenas nos casos em que a consulta for parte essencial do processo de integração.
Caso sua aplicação realmente precise utilizar o GET específico no ambiente de produção, será necessário entrar em
contato com o suporte da Mercos, explicar o motivo da solicitação e anexar uma justificativa técnica.
Após o envio, o pedido será encaminhado ao time responsável, que avaliará a possibilidade de liberação desse recurso.
Se sua aplicação estiver enfrentando dificuldades para buscar registros usando o GET geral, pode ser necessário
solicitar a liberação do GET específico. Para isso, siga os passos abaixo:
- Abra uma solicitação: Entre em contato com o suporte da Mercos.
- Envie a documentação: Anexe uma justificativa que explique a necessidade do uso do GET específico.
Após o recebimento da sua solicitação, nossa equipe de suporte encaminhará o caso para o time técnico. Eles avaliarão sua solicitação e determinarão a viabilidade da liberação.