API PARA DESARROLLADORES

API de identificacion de plantas por foto

Integra reconocimiento de plantas por foto en tu app, flujo interno o portal de clientes. La API acepta una imagen, revisa rasgos visibles y devuelve JSON con nombre comun, nombre cientifico, familia, cuidados, parecidas y siguiente paso.

Entrada por foto
Salida JSON
Claves API
POST /api/plant/identify
curl -X POST https://api.plantidentify.org/api/plant/identify \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "[email protected]" \
  -F "lang=es"

Como funciona el flujo de la API Plant Identifier

El flujo publico refleja el identificador web: sube una foto clara, autentica la solicitud y usa el resultado estructurado en tu producto.

1

Crea una clave API

Inicia sesion, abre Claves API y crea una clave para tu integracion. Mantenla en el servidor y rotala si cambia el acceso.

2

Envia una foto de planta

Sube una imagen JPG, PNG o WEBP desde tu app. Hojas, flores, tallos o planta completa con buena luz dan mejores coincidencias.

3

Lee el JSON

Usa nombre comun, nombre cientifico, familia, cuidados, confianza, parecidas y foto sugerida desde la respuesta.

4

Muestra el siguiente paso

Guia al usuario hacia confirmacion, cuidados, seguridad o una segunda imagen cuando el resultado sea incierto.

Ejemplo de solicitud y respuesta de la API

Usa este ejemplo para planificar manejo de solicitudes, tarjetas de resultado, registros y estados alternativos antes de enviar trafico real.

Solicitud
POST https://api.plantidentify.org/api/plant/identify
Authorization: Bearer YOUR_TOKEN
Content-Type: multipart/form-data

image: monstera.jpg
lang: es
context: plant
Respuesta
{
  "success": true,
  "data": {
    "common_name": "Monstera",
    "scientific_name": "Monstera deliciosa",
    "family": "Araceae",
    "confidence": 0.86,
    "care": {"light": "Luz indirecta brillante", "watering": "Regar cuando se seque la capa superior"},
    "lookalikes": ["Filodendro de hoja partida", "Rhaphidophora"],
    "next_step": "Sube una foto de hoja completa y tallo si necesitas mas confirmacion."
  }
}
Nota de implementacion: Trata el resultado como coincidencia guiada, no como garantia botanica. Muestra incertidumbre y evita usar una sola respuesta para decisiones de comestibilidad, salud o toxicidad.

Que puede recibir tu app

La API ayuda a equipos que necesitan mas que una suposicion visual: busqueda, educacion, cuidados y prompts de seguimiento.

Nombres de plantas

Devuelve nombre comun y cientifico cuando la imagen contiene evidencia suficiente.

Familia y parecidas

Incluye contexto de familia y plantas similares para comparar candidatos.

Cuidados

Muestra luz, riego y notas practicas cuando estan disponibles.

Notas de seguridad

Anade contexto cauteloso para mascotas, ninos o manejo sensible.

Siguiente foto

Sugiere hoja, flor, tallo, corteza o planta completa para confirmar.

JSON estructurado

Usa campos previsibles en apps moviles, herramientas de jardin y flujos internos.

Casos de uso ideales

Funciona mejor cuando tu producto necesita una lista rapida de coincidencias por foto y guia practica.

Apps de jardineria y cuidado

Identifica plantas de interior, flores, arboles, malezas o suculentas antes de mostrar planes de cuidado.

Viveros y ecommerce

Clasifica preguntas, etiqueta fotos o recoge mejor contexto antes de responder.

Educacion y ciencia ciudadana

Convierte una foto de campo en nombre probable, evidencias y observacion siguiente.

Triage interno de imagenes

Precompleta nombres y categorias para revision manual o bases de conocimiento.

Precision, privacidad y limites

El reconocimiento por foto es util, pero tu producto debe manejar incertidumbre y decisiones sensibles.

Caso Manejo recomendado
Foto borrosa o lejana Pide una imagen mas cercana y con mejor luz.
Varias plantas en la imagen Pide recortar o repetir la foto con un solo sujeto.
Posible planta comestible o toxica Muestra advertencia y exige verificacion local cualificada.
Baja confianza Muestra coincidencias, parecidas y la siguiente foto recomendada.

Preguntas frecuentes sobre la API

Si. La API acepta una foto de planta y devuelve JSON con nombres probables, familia, cuidados, parecidas y siguiente paso cuando esta disponible.

Usa JPG, PNG o WEBP con una planta clara. Fotos nitidas de hojas, flores, tallos o planta completa funcionan mejor.

Si. Mantén la clave API en tu servidor, envia la imagen desde tu app a tu backend y devuelve solo los campos que necesita la interfaz.

Cuando el match lo permite, puede incluir luz, riego, cuidado, seguridad, parecidas y foto siguiente.

No. Depende de la calidad de imagen, rasgos visibles y especies parecidas. Muestra confianza y opciones.

No como unica fuente. Para toxicidad, alimento, alergias, mascotas o tratamientos, exige verificacion local cualificada.

Despues de iniciar sesion, usa la pagina Claves API para crear y administrar claves de tu cuenta.

Integra identificacion de plantas en tu producto

Crea una clave API, prueba el flujo por foto y devuelve resultados utiles dentro de tu app.