Explorar la API

Los 28 endpoints de la API upCampo, generados a partir del openapi.json: abra uno de ellos para ver los parámetros, los campos del cuerpo y el formato de la respuesta. Para entender qué significa cada uno —el papel del ID_REFERENCIA, la ventana de siete días, el prorrateo de la orden de servicio—, vea la documentación escrita.

Cómo probar

Abra POST /autenticar, haga clic en Try it out y pegue en el cuerpo el JSON de credenciales que upCampo le entregó.
Haga clic en Execute. Si funciona, el token se aplica solo: el candado de arriba se cierra y el campo Authorize ya queda completado. No hace falta copiar nada a mano.
A partir de ahí, se puede ejecutar cualquier GET: ábralo, complete los parámetros y Execute.

El token vale 24 horas y queda guardado en el navegador: si vuelve aquí mañana, repita el paso 1. ¿Ya tiene un token? Haga clic directamente en Authorize y péguelo.

¿Prefiere trabajar en Postman?

Esta misma lista se convierte en una colección lista en pocos clics, y allí los POST funcionan, que es lo que esta página bloquea a propósito. En Postman, haga clic en Import, elija Link y pegue:

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

Arma la colección con los 28 endpoints, ya con los parámetros, los cuerpos de ejemplo y la variable baseUrl apuntando a https://api.upcampo.com.br. Después abra Authorization en la colección, elija Bearer Token y pegue el token de POST /autenticar: así vale para todas las solicitudes de una vez.

Vale lo mismo para Insomnia (Import from URL) y para los generadores de clientes, que crean el código en Java, C# o Python a partir del mismo archivo.

Las llamadas van a la base real

No existe un ambiente de prueba incorporado: el token trae la empresa y el establecimiento fijados, y toda llamada hecha desde aquí llega a la base de producción de ese establecimiento.

Por eso solo se ejecutan /autenticar y los GET. Los demás POST —movimiento, romaneo, inventario, fardo— siguen documentados, con el cuerpo de ejemplo listo para copiar, pero la ejecución está bloqueada en esta página: un clic distraído grabaría un documento de verdad. Para enviarlos, use Postman o curl, con el mismo token.