Primeros pasos

URL base

Todas las rutas de negocio empiezan por /api/v1.

https://api-fito.fitosanitariosmartinpaez.com/api/v1

La instancia local usa http://localhost:8000.

Primera búsqueda

Busca productos que contengan una sustancia activa:

curl "https://api-fito.fitosanitariosmartinpaez.com/api/v1/productos?sustancia=glifosato"

La respuesta está paginada:

{
  "items": [],
  "total": 0,
  "pagina": 1,
  "por_pagina": 50,
  "total_paginas": 0,
  "fuente": "json_export"
}

items contiene los resultados. fuente indica qué origen se utilizó para resolver la consulta.

Reglas comunes

• Los filtros de texto son parciales y no distinguen mayúsculas de minúsculas.
• pagina empieza en 1.
• por_pagina vale 50 por defecto y nunca puede superar 200, salvo en catálogos, donde el máximo es 500.
• Los valores que forman parte de la ruta deben codificarse como URL. Por ejemplo, Oídio se expresa como O%C3%ADdio.

Explorar desde el navegador

La API publica la especificación OpenAPI y dos exploradores interactivos:

• Swagger UI: /docs
• ReDoc: /redoc
• OpenAPI JSON: /openapi.json

Arranque local

git clone https://github.com/paez28/api-mapya.git
cd api-mapya
python -m venv .venv
.venv\Scripts\activate  # En Windows
pip install -e ".[dev]"
uvicorn api_fito.main:app --reload --port 8000

Con Docker:

docker compose up --build