API SVILUPPATORI

API di identificazione piante da foto

Integra il riconoscimento delle piante da foto nella tua app, workflow o portale clienti. L'API accetta un'immagine e restituisce JSON con nome comune, nome scientifico, famiglia, cura, piante simili e prossimo passo.

Input foto
Output JSON
Chiavi 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=it"

Come funziona il workflow dell'API Plant Identifier

Il flusso segue l'identificatore web: invia una foto chiara, autentica la richiesta e usa il risultato strutturato nel tuo prodotto.

1

Crea una chiave API

Accedi, apri Chiavi API e crea una chiave per l'integrazione. Tienila lato server e ruotala quando cambia l'accesso.

2

Invia una foto della pianta

Carica un'immagine JPG, PNG o WEBP dalla tua app. Foglie, fiori, steli o pianta intera nitidi danno risultati migliori.

3

Leggi il JSON

Usa nome comune, nome scientifico, famiglia, cura, confidenza, piante simili e foto successiva suggerita.

4

Mostra il prossimo passo

Guida l'utente verso conferma, cura, controllo di sicurezza o seconda immagine quando il risultato e incerto.

Esempio di richiesta e risposta API

Usa questo esempio per pianificare richieste, schede risultato, log e stati fallback prima del traffico reale.

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

image: monstera.jpg
lang: it
context: plant
Risposta
{
  "success": true,
  "data": {
    "common_name": "Monstera",
    "scientific_name": "Monstera deliciosa",
    "family": "Araceae",
    "confidence": 0.86,
    "care": {"light": "Luce indiretta intensa", "watering": "Annaffia quando il terriccio in superficie si asciuga"},
    "lookalikes": ["Filodendro", "Rhaphidophora"],
    "next_step": "Carica una foto di foglia intera e stelo se ti serve piu conferma."
  }
}
Nota di implementazione: Tratta il risultato come corrispondenza guidata, non come garanzia botanica. Mostra incertezza e non usare una sola risposta per decisioni alimentari, mediche o tossicologiche.

Cosa puo ricevere la tua app

L'API aiuta i team che hanno bisogno di piu di un suggerimento visivo: ricerca, educazione, cura e prompt successivi.

Nomi delle piante

Restituisce nome comune e scientifico quando l'immagine contiene indizi sufficienti.

Famiglia e simili

Mostra contesto di famiglia e piante simili per confrontare i candidati.

Contesto di cura

Fornisce luce, irrigazione e note pratiche quando disponibili.

Note di sicurezza

Aggiunge avvisi prudenti per animali, bambini, manipolazione e casi sensibili.

Foto successiva

Suggerisce foglia, fiore, stelo, corteccia o pianta intera per confermare.

JSON strutturato

Usa campi prevedibili per app mobili, strumenti di giardinaggio e workflow interni.

Casi d'uso ideali

Funziona meglio quando il prodotto richiede una shortlist rapida da foto e indicazioni pratiche.

App di giardinaggio e cura

Identifica piante da interno, fiori, alberi, infestanti o succulente prima di mostrare promemoria e profili.

Vivai ed ecommerce

Instrada domande clienti, etichetta foto o raccogli contesto prima della risposta supporto.

Educazione e citizen science

Trasforma una foto sul campo in nome probabile, checklist di prove e prossima osservazione.

Triage immagini interno

Precompila nomi e categorie per code di revisione, knowledge base o dashboard.

Accuratezza, privacy e limiti

Il riconoscimento da foto e utile, ma il prodotto deve gestire incertezza e decisioni sensibili.

Caso Gestione consigliata
Foto sfocata o distante Chiedi un'immagine piu vicina e luminosa.
Piu piante nella foto Chiedi di ritagliare o rifare la foto su un solo soggetto.
Possibile pianta commestibile o tossica Mostra un avviso e richiedi verifica locale qualificata.
Bassa confidenza Mostra candidati, simili e la prossima foto consigliata.

FAQ sull'API di identificazione piante

Si. L'API accetta una foto di pianta e restituisce JSON con nomi probabili, famiglia, cura, piante simili e prossimo passo.

Usa JPG, PNG o WEBP con una pianta chiara. Foglie, fiori, steli o vista completa nitidi funzionano meglio.

Si. Mantieni la chiave API sul server, invia l'immagine tramite backend e restituisci solo i campi necessari all'app.

Quando il match lo consente, puo includere luce, irrigazione, cura, sicurezza, simili e foto successiva.

No. Dipende da qualita immagine, tratti visibili e specie simili. Mostra confidenza e candidati.

Non come unica fonte. Per tossicita, cibo, allergie, animali o trattamenti, richiedi verifica locale qualificata.

Dopo l'accesso, usa la pagina Chiavi API per creare e gestire le chiavi dell'account.

Integra Plant ID nel tuo prodotto

Crea una chiave API, prova il flusso fotografico e mostra risultati utili nella tua app.