Explorar a API

Os 28 endpoints da API upCampo, gerados a partir do openapi.json: abra um deles para ver os parâmetros, os campos do corpo e o formato do retorno. Para entender o que cada um significa — o papel do ID_REFERENCIA, a janela de sete dias, o rateio da ordem de serviço —, veja a documentação escrita.

Como testar

Abra POST /autenticar, clique em Try it out e cole no corpo o JSON de credenciais que a upCampo lhe entregou.
Clique em Execute. Dando certo, o token é aplicado sozinho — o cadeado do topo fecha e o campo Authorize já fica preenchido. Não precisa copiar nada à mão.
A partir daí, qualquer GET pode ser executado: abra, preencha os parâmetros e Execute.

O token vale 24 horas e fica guardado no navegador — ao voltar aqui amanhã, refaça o passo 1. Já tem um token? Clique direto em Authorize e cole.

Prefere trabalhar no Postman?

Esta mesma lista vira uma coleção pronta em poucos cliques — e lá os POST funcionam, que é o que esta página bloqueia de propósito. No Postman, clique em Import, escolha Link e cole:

https://suporte.upcampo.com.br/api/openapi.json

Ele monta a coleção com os 28 endpoints, já com os parâmetros, os corpos de exemplo e a variável baseUrl apontando para https://api.upcampo.com.br. Depois abra Authorization na coleção, escolha Bearer Token e cole o token de POST /autenticar — assim ele vale para todas as requisições de uma vez.

Vale igual para o Insomnia (Import from URL) e para geradores de cliente, que criam o código em Java, C# ou Python a partir do mesmo arquivo.

As chamadas vão para a base real

Não existe ambiente de teste embutido: o token traz empresa e fazenda fixadas, e toda chamada daqui bate na base de produção daquela fazenda.

Por isso só o /autenticar e os GET executam. Os demais POST — movimentação, romaneio, inventário, fardo — continuam documentados, com o corpo de exemplo pronto para copiar, mas a execução é bloqueada nesta página: um clique distraído gravaria documento de verdade. Para enviá-los, use o Postman ou o curl, com o mesmo token.