API de integradores
Tres productos sobre datos satelitales, con informe PDF firmado: actividad eléctrica, edificación y peritaje de daños.
Este API responde tres preguntas y, si hace falta, emite el informe que las documenta. No hace falta entrar a la consola para usarlo: alcanza con la clave de API que te entregamos.
| Producto | La pregunta | Por dónde empezar |
|---|---|---|
| Actividad eléctrica | ¿Cayó un rayo cerca del punto, en la ventana? | Guía |
| Edificación | ¿Hay construcción en el lote, y cuánta? | Guía |
| Peritaje de daños | ¿Cuánto daño dejó el evento sobre el lote? | Guía |
Los tres tienen la misma forma: una evaluación barata que responde la pregunta, y una emisión que devuelve el PDF. La evaluación no obliga a emitir — si el resultado ya te alcanza, ahí terminás.
Antes de la primera llamada
- Autenticación:
Authorization: Bearer uco_live_…(producción) ouco_sbox_…(sandbox). No son intercambiables: usar una contra el entorno del otro responde401 environment_mismatch. Idempotency-Keyes obligatoria en todo lo que gasta cuota. Sin ella la respuesta es428.- Los errores traen
retryable, así que no hace falta mantener una tabla propia de qué conviene reintentar.
La mecánica transversal —ciclo de vida del trabajo, descarga estable y la tabla completa de códigos— está en Trabajos, entrega y errores.
El sandbox
https://sbox.ucotron.com sirve las mismas rutas con datos de fixture y sin
costo. Devuelve informes PDF reales, que abren; lo que no hace es reflejar los
parámetros de tu pedido en el contenido. Y no guarda estado: los listados vienen
vacíos y los trabajos nacen terminados.