CORPOAMAZONIA · FAO
FAO: Organización de las Naciones Unidas para la Alimentación y la Agricultura.
SRV Interoperabilidad · Monitoreo comunitario

Sistema de Interoperabilidad SRV — API SARA

Documento operativo del Sistema de Interoperabilidad SRV (Seguimiento, Reporte y Validación) con enfoque de monitoreo comunitario. Las rutas protegidas requieren Authorization: Bearer <Firebase_ID_Token>.

Contexto Interoperabilidad (SRV) Endpoints públicos Endpoints protegidos Ejemplos
Base URL
https://api.corpoamazonia.gov.co
Autenticación (operación)
Firebase ID Token (Bearer) + control por rol/módulo
Formato
JSON (en endpoints de datos)
Carta de Acuerdo (referencia)
OC 2312889 GCP/COL/121/GCF
Sistema de Seguimiento, Reporte y Validación (SRV) con enfoque de monitoreo comunitario e interoperabilidad

Contexto: interoperabilidad SRV y Carta de Acuerdo

¿Qué significa interoperabilidad SRV aquí?
En este sistema, interoperabilidad es la capacidad de integrar (captura comunitaria), estandarizar (calidad/consistencia), verificar (trazabilidad SRV) y reportar información para monitoreo comunitario, seguimiento y control, con datos georreferenciados y evidencia operativa.
  • Seguimiento: registro de monitoreos, predios/UMS, coordenadas y eventos de campo.
  • Reporte: consolidación de resultados (muestras/monitoreos/informes) para análisis y gestión.
  • Validación/Verificación: revisión de calidad, coherencia y respaldo del dato (roles y trazabilidad).
Cómo se relaciona con la Carta de Acuerdo FAO–CORPOAMAZONÍA
Esta documentación se enmarca como soporte técnico del acuerdo entre FAO y CORPOAMAZONÍA para fortalecer capacidades y la implementación de mecanismos e instrumentos de monitoreo, vigilancia y control, incluyendo el diseño/fortalecimiento del SRV y la implementación operativa del monitoreo comunitario.
  • Referencia: OC 2312889 · Proyecto GCP/COL/121/GCF.
  • Enfoque: transparencia, gobernanza y sostenibilidad; pilotaje y consolidación de información.
  • Producto esperado: procesos/herramientas SRV fortalecidos y operación del monitoreo comunitario.

Interoperabilidad (SRV) — endpoints clave

Estos son los endpoints principales para el flujo SRV (monitoreo, predios/UMS, muestras, coordenadas e informes).
Método Ruta Descripción Auth
GET /monitoring Monitoreos (paginado) / interoperabilidad Sí (Firebase Bearer)
REST /monitorings Crear/actualizar monitoreos Sí (Firebase Bearer)
GET /samples/report/data Reporte de muestras (SRV) Sí (Firebase Bearer)
REST /samples Registro y gestión de muestras Sí (Firebase Bearer)
POST /property/create-app Registro de predio desde app Sí (Firebase Bearer)
REST /property Gestión de predios Sí (Firebase Bearer)
GET /ums/user/{userId} Unidades de manejo sostenible (UMS) por usuario Sí (Firebase Bearer)
REST /ums Gestión UMS Sí (Firebase Bearer)
REST /PredioCoordenadas Coordenadas de predios (geometría) Sí (Firebase Bearer)
REST /UmsCoordenadas Coordenadas UMS (geometría) Sí (Firebase Bearer)
REST /informs Informes (seguimiento/reporte) Sí/No (revisar)

Endpoints públicos

Método Ruta Descripción Auth
GET / Inicio / documentación del API No
POST /auth Login (email/password) No
POST /auth/login Login con Google/Firebase No
POST /auth/logout Logout (sesión) No
GET /departments Listado de departamentos No
GET /cities Listado de municipios No
GET /glossary Glosario No
GET /helps Ayudas No
GET /sabias-que Contenido “Sabías que” No
GET /page/top-species Top especies No
GET /page/content Contenido de página No
GET /page/slider/images Slider (general) No
GET /page/slider/images/{id} Slider por id No
POST /page/count/{id} Contador de visitas No
POST /page/contact/aboutus Contacto (correo) No
GET /nurseries Listado de viveros (público) No
GET /species Listado especies No
GET /species/flat Especies (flat) No
GET /species/sisa Especies SISA No
POST /species/gbif Guardar especie GBIF No
GET /species/gbif/verify/{taxonKey} Verificar especie GBIF existe No
GET /species/consolidated Especies consolidadas No
GET /species/search/code/{code} Buscar por código No
GET /species/search/family/{name} Buscar familia por nombre No
GET /species/families Familias con especies No
GET /species/all Todas (flat) No
GET /species/all/full/{code} Detalle por código No
GET /candidates/geolocation Candidatos (geolocalización) No
POST /users/register Registro de usuario No
GET /users/verify-email/{token} Verificar email No
POST /users/resend-verification Reenviar verificación No
GET /users/roles Roles No
GET /monitoring/user/{id} Monitoreos por usuario No
GET /property/file/details/{fileId} Detalle de archivo (pruebas) No

Endpoints protegidos

Método Ruta Descripción Auth
GET /users/modules Permisos/módulos por usuario Sí (Firebase Bearer)
PUT /users/{id} Actualizar perfil Sí (Firebase Bearer)
GET /users/validate/all Usuarios por validar Sí (Firebase Bearer)
REST /users/validate CRUD validaciones Sí (Firebase Bearer)
REST /users CRUD usuarios Sí (Firebase Bearer)
POST /helps/{id} Actualizar ayuda (usando POST) Sí (Firebase Bearer)
REST /helps CRUD ayudas Sí (Firebase Bearer)
GET /nurseries/admin Viveros (admin) Sí (Firebase Bearer)
REST /nurseries CRUD viveros Sí (Firebase Bearer)
REST /nurseries/admin CRUD asignación admin viveros Sí (Firebase Bearer)
POST /property/users/species/app Crear especie expediente (app) Sí (Firebase Bearer)
GET /property/users/species/{userId} Especies por usuario Sí (Firebase Bearer)
REST /property/users/species CRUD especies expediente Sí (Firebase Bearer)
POST /property/create-app Crear predio desde app Sí (Firebase Bearer)
GET /property/users/record-search/{userId} Buscar registros de predios Sí (Firebase Bearer)
GET /property/users/{userId} Archivos de predio por usuario Sí (Firebase Bearer)
GET /property/search/{userId} Predios por usuario Sí (Firebase Bearer)
GET /property/users/monitoring Predios para monitoreo Sí (Firebase Bearer)
REST /property/users CRUD archivos predio Sí (Firebase Bearer)
REST /property CRUD predios Sí (Firebase Bearer)
POST /species/{id} Actualizar especie (usando POST) Sí (Firebase Bearer)
REST /species CRUD especies Sí (Firebase Bearer)
GET /candidates/trees/{userId} Candidatos (árboles) por usuario Sí (Firebase Bearer)
GET /candidates/user/{userId} Candidatos por usuario Sí (Firebase Bearer)
GET /candidates/search/{code} Candidatos por código Sí (Firebase Bearer)
GET /candidates/trees/{numeroPlaca} Candidato por número placa Sí (Firebase Bearer)
REST /candidates/trees CRUD candidatos (árboles) Sí (Firebase Bearer)
GET /monitoring Monitoreos (paginado) Sí (Firebase Bearer)
GET /monitoring/report/general/total Reporte general Sí (Firebase Bearer)
GET /monitoring/specie/search/{code} Buscar por especie Sí (Firebase Bearer)
GET /monitoring/candidate/search/{term} Buscar por candidato Sí (Firebase Bearer)
REST /monitorings CRUD monitoreos Sí (Firebase Bearer)
GET /PredioCoordenadas/user/{userId} Coordenadas predio por usuario Sí (Firebase Bearer)
REST /PredioCoordenadas CRUD coordenadas predio Sí (Firebase Bearer)
GET /samples/report/data Reporte de muestras Sí (Firebase Bearer)
REST /samples CRUD muestras Sí (Firebase Bearer)
POST /page/slider/{id} Actualizar slider (usando POST) Sí (Firebase Bearer)
POST /page/slider/order Ordenar slider Sí (Firebase Bearer)
REST /page/slider CRUD slider Sí (Firebase Bearer)
REST /resources/species CRUD recursos por especie Sí (Firebase Bearer)
GET /umscoordenadas/user/{userId} Coordenadas UMS por usuario Sí (Firebase Bearer)
GET /ums/user/{userId} UMS por usuario Sí (Firebase Bearer)
GET /ums/predio/{predioId} UMS por predio Sí (Firebase Bearer)
REST /ums CRUD UMS Sí (Firebase Bearer)
REST /UmsCoordenadas CRUD coordenadas UMS Sí (Firebase Bearer)
GET /candidates/palmas/user/{userId} Candidatos palmas por usuario Sí (Firebase Bearer)
REST /candidates/palmas CRUD candidatos palmas Sí (Firebase Bearer)
GET /candidates/arboles/user/{userId} Candidatos árboles por usuario Sí (Firebase Bearer)
REST /candidates/arboles CRUD candidatos árboles Sí (Firebase Bearer)
GET /metodo-muestreo-especie/user/{userId} Método muestreo por usuario Sí (Firebase Bearer)
REST /metodo-muestreo-especie CRUD método muestreo Sí (Firebase Bearer)
POST /detalle-especie/upload Subir archivo detalle especie Sí (Firebase Bearer)
GET /detalle-especie/user/{userId} Detalle especie por usuario Sí (Firebase Bearer)
REST /detalle-especie CRUD detalle especie Sí (Firebase Bearer)
REST /informs CRUD informes (resource) Sí/No (revisar: hoy está fuera del group)
Nota: “REST” indica rutas creadas con $routes->resource(...) (index/show/create/update/delete) según convención de CodeIgniter 4.

Ejemplos rápidos

curl -X GET "https://api.corpoamazonia.gov.co/species"
curl -X GET "https://api.corpoamazonia.gov.co/monitoring" \
  -H "Authorization: Bearer <FIREBASE_ID_TOKEN>"
curl -X POST "https://api.corpoamazonia.gov.co/auth/login" \
  -H "Authorization: Bearer <FIREBASE_ID_TOKEN>"