API PARA DESENVOLVEDORES

API de identificacao de plantas por foto

Adicione reconhecimento de plantas por foto ao seu app, fluxo interno ou portal de clientes. A API aceita uma imagem e retorna JSON com nome comum, nome cientifico, familia, cuidados, parecidas e proximo passo.

Entrada por foto
Saida JSON
Chaves 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=pt"

Como funciona o fluxo da API Plant Identifier

O fluxo segue o identificador web: enviar uma foto nítida, autenticar a requisição e usar o resultado estruturado no seu produto.

1

Crie uma chave API

Entre na conta, abra Chaves API e crie uma chave para a integração. Mantenha a chave no servidor e troque-a quando o acesso mudar.

2

Envie uma foto da planta

Envie uma imagem JPG, PNG ou WEBP pelo seu app. Folhas, flores, caules ou a planta inteira com boa luz geram resultados melhores.

3

Leia o JSON

Use nome comum, nome científico, família, contexto de cuidado, confiança, plantas parecidas e a próxima foto sugerida.

4

Mostre o próximo passo

Oriente o usuário para confirmação, cuidados, verificação de segurança ou uma segunda imagem quando houver incerteza.

Exemplo de requisição e resposta da API

Use este exemplo para planejar tratamento de requisições, cards de resultado, logs e estados alternativos antes do tráfego real.

Requisição
POST https://api.plantidentify.org/api/plant/identify
Authorization: Bearer YOUR_TOKEN
Content-Type: multipart/form-data

image: monstera.jpg
lang: pt
context: plant
Resposta
{
  "success": true,
  "data": {
    "common_name": "Monstera",
    "scientific_name": "Monstera deliciosa",
    "family": "Araceae",
    "confidence": 0.86,
    "care": {"light": "Luz indireta brilhante", "watering": "Regar quando a superfície do solo secar"},
    "lookalikes": ["Filodendro", "Rhaphidophora"],
    "next_step": "Envie uma foto da folha inteira e do caule se precisar confirmar melhor."
  }
}
Nota de implementação: Trate o resultado como uma correspondência guiada, não como garantia botânica. Mostre incerteza e não use uma única resposta para decisões de consumo, saúde ou toxicidade.

O que seu app pode receber

A API foi criada para equipes que precisam de mais do que um palpite visual: busca, educação, cuidados e prompts de acompanhamento.

Nomes de plantas

Retorna nome comum e científico quando a imagem contém evidência suficiente.

Família e parecidas

Inclui contexto de família e plantas semelhantes para comparar candidatos.

Contexto de cuidado

Mostra luz, rega e notas práticas quando disponíveis para a planta provável.

Notas de segurança

Traz contexto cauteloso para pets, crianças, manuseio e usos sensíveis.

Próxima foto

Sugere folha, flor, caule, casca ou planta inteira para melhorar a confirmação.

JSON estruturado

Use campos previsíveis em apps móveis, ferramentas de jardim e fluxos internos.

Melhores casos de uso da API

A API funciona melhor quando seu produto precisa de uma lista rápida por foto e orientação prática.

Apps de jardinagem e cuidado

Identifique plantas de interior, flores, árvores, ervas daninhas ou suculentas antes de mostrar lembretes e perfis.

Viveiros e ecommerce

Classifique dúvidas de clientes, rotule fotos ou colete contexto antes do suporte responder.

Educação e ciência cidadã

Transforme uma foto de campo em nome provável, checklist de evidências e próxima observação.

Triagem interna de imagens

Pré-preencha nomes e categorias para filas de revisão, bases de conhecimento ou dashboards.

Precisão, privacidade e limites

Reconhecimento por foto é útil, mas o produto deve lidar com incerteza e decisões sensíveis.

Caso Tratamento recomendado
Foto desfocada ou distante Peça uma imagem mais próxima e com melhor luz.
Várias plantas na imagem Peça para recortar ou fotografar apenas uma planta.
Possível planta comestível ou tóxica Mostre alerta e exija verificação local qualificada.
Baixa confiança Mostre candidatos, parecidas e a próxima foto recomendada.

Perguntas frequentes sobre a API

Sim. A API aceita uma foto de planta e retorna JSON com nomes prováveis, família, cuidados, parecidas e próximo passo quando disponível.

Use JPG, PNG ou WEBP com uma planta clara. Fotos nítidas de folhas, flores, caules ou planta inteira funcionam melhor.

Sim. Mantenha a chave API no seu servidor, envie a imagem pelo backend e retorne ao app apenas os campos necessários.

Quando o match permite, pode incluir luz, rega, cuidado, segurança, plantas parecidas e próxima foto.

Não. Depende da qualidade da imagem, dos traços visíveis e de espécies parecidas. Mostre confiança e candidatos.

Não como única fonte. Para toxicidade, consumo, alergias, pets ou tratamentos, exija verificação local qualificada.

Depois de entrar, use a página Chaves API para criar e gerenciar as chaves da conta.

Inclua identificacao de plantas no seu produto

Crie uma chave API, teste o fluxo por foto e entregue resultados uteis no seu app.