AgroMaps IA
API Partner v1
REST JSON en el mismo dominio. Autenticación con X-Api-Key o Authorization: Bearer agk_live_….
Inicio rápido
curl -s "https://www.agromapsia.com/api/v1/partner/health" \
-H "X-Api-Key: agk_live_TU_CLAVE"curl -s "https://www.agromapsia.com/api/v1/partner/summary?days=30" \
-H "Authorization: Bearer agk_live_TU_CLAVE"Respuesta estándar: { "ok": true, "meta": { ... }, "data": { ... } }
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /api/v1/partner/health | Estado del servicio |
| GET | /api/v1/partner/me | Plan, límites y BYOK |
| GET | /api/v1/partner/plans | Planes públicos |
| GET | /api/v1/partner/summary | Resumen agregado (sin GPS exacto) |
| GET | /api/v1/partner/crops | Catálogo de cultivos |
| GET | /api/v1/partner/heatmaps | Heatmaps (mismos filtros que mapa) |
| GET | /api/v1/partner/propagation | Zonas de propagación |
| GET | /api/v1/partner/risk/national | Índice nacional de riesgo |
| GET | /api/v1/partner/alerts | Alertas (coordenadas redondeadas) |
| GET | /api/v1/partner/weather | Clima (?lat=&lng=) |
| GET | /api/v1/partner/reports/aggregated | Grilla agregada (?cell_size=0.1) |
| GET/POST | /api/v1/partner/ai/predict | Predicción IA (plan o BYOK OpenAI) |
| GET | /api/v1/partner/satellite | Capa satélite NDVI |
| GET | /api/v1/partner/export/summary.csv | Export CSV resumen |
| GET | /api/v1/partner/config/maps | Clave Google Maps si el plan/BYOK lo permite |
Planes y facturación
La colaboración en el mapa web sigue gratuita. Los planes API controlan límites diarios, cuota de IA de plataforma y BYOK (claves propias).
| Plan | Precio/mes | Req/día | IA/mes | BYOK |
|---|---|---|---|---|
| Trial trial |
$0.00 | 200 | 0 | No |
| Business business |
$49.00 | 5000 | 500 | No |
| Pro pro |
$149.00 | 25000 | 2000 | Sí |
| Enterprise enterprise |
$499.00 | 100000 | 50000 | Sí |
Auto-registro: https://www.agromapsia.com/partner/register — cuenta Trial; debes confirmar el email antes de usar la API key.
Alta manual: Admin → API Partner → Crear cliente API (contraseña temporal por email).
Subir de plan: Portal → Facturación con PayPal o billing_status manual en admin.
OpenAI y Google Maps
- Plataforma: planes Business+ usan las claves configuradas en Admin → Integraciones (cuota mensual de IA).
- BYOK: planes Pro/Enterprise pueden guardar su propia OpenAI y/o Google Maps en el cliente API (sin consumir tu cuota de IA).
- Si no hay clave OpenAI,
/ai/predictresponde con motor local de respaldo.
Portal autoservicio
Tras el alta por administrador, la empresa entra con email y contraseña temporal, gestiona BYOK y suscripción:
- Login: https://www.agromapsia.com/partner/login
- Facturación PayPal: https://www.agromapsia.com/partner/billing
- Cambiar contraseña: enlace del correo de bienvenida →
/partner/activate/{token}
Registro: /partner/register · Login: /partner/login
Privacidad
La API partner no expone nombres de agricultores ni coordenadas exactas de fincas en agregados. Las alertas usan coordenadas redondeadas a ~0.1°.