Saltar al contenido principal

Farms Metadata API

Descripción General​

API para gestionar los metadatos de campos/establecimientos. Permite consultar metadatos de múltiples campos y actualizar los metadatos de un campo específico.

Endpoints​

GET /api/farms/metadata​

Obtiene los metadatos de una o más campos.

Parámetros de Query​

ParámetroTipoRequeridoDescripción
farms_idstringNoLista de IDs de campos separados por coma (ej: "1,2,3"). Si se omite, retorna datos de todos los campos accesibles

Ejemplo de Request​

GET /api/farms/metadata?farms_id=1,2,3

Respuesta Exitosa (200 OK)​

{
"data": {
"1": {
"metadata": {
"info_interna": {
"id_interno": "5551234",
"contacto": "granja1@ejemplo.com"
},
"detalles_campo": {
// etc
}
}
},
"2": {
"metadata": {
// metadatos de campo 2
}
}
}
}

PATCH /api/farms/metadata​

Actualiza los metadatos de un campo específico.

Parámetros del Body​

ParámetroTipoRequeridoDescripción
farm_idintegerSíID del campo a actualizar
metadataobjectSíObjeto JSON con los metadatos a actualizar

Ejemplo de Body​

{
"farm_id": 1,
"metadata": {
"info_interna": {
"id_interno": "5551234"
},
// etc
}
}

Respuesta Exitosa (200 OK)​

{
"data": {
"metadata": {
// metadatos actualizados
}
}
}

Respuesta de Error (400 Bad Request)​

{
"info": "Error could not update metadata"
}

Códigos de Estado​

CódigoDescripción
200Operación exitosa
400Error en la validación o actualización
401No autorizado
403Acceso denegado