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ámetro | Tipo | Requerido | Descripción |
---|---|---|---|
farms_id | string | No | Lista 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ámetro | Tipo | Requerido | Descripción |
---|---|---|---|
farm_id | integer | Sí | ID del campo a actualizar |
metadata | object | Sí | 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ódigo | Descripción |
---|---|
200 | Operación exitosa |
400 | Error en la validación o actualización |
401 | No autorizado |
403 | Acceso denegado |