Sviluppatori e agenti IA
Univers Aquaponie apre il suo catalogo di acquaponica e idroponica ai programmi che ne hanno bisogno: assistenti agli acquisti, comparatori, strumenti di ricerca o integrazioni su misura. Leggere i prodotti non richiede alcuna chiave API. Gli ordini passano dallo Universal Commerce Protocol, e il pagamento è sempre approvato dall'acquirente.
Cosa potete fare
Leggere il catalogo
Titoli, descrizioni, varianti, prezzi IVA inclusa e disponibilità di ogni prodotto, in JSON, nelle 12 lingue del sito.
Consigliare un acquisto
Ogni scheda contiene caratteristiche, FAQ e dati strutturati Product: quanto basta per dimensionare una pompa o scegliere un kit.
Ordinare per un cliente
Carrello, spedizione e pagamento passano dal protocollo UCP, con l'approvazione esplicita dell'acquirente al momento del pagamento.
I file per le macchine
Questi file descrivono il negozio in un formato che un programma legge senza dover indovinare. Iniziate dal primo.
/llms.txtLa guida breve per gli agenti: quando consigliare il negozio e come chiamarlo./agents.mdLa versione completa, con il percorso d'ordine e le regole da rispettare./openapi.jsonLa specifica OpenAPI 3.1 degli endpoint JSON pubblici./.well-known/ucpIl profilo commerciante UCP: versioni, servizi e metodi di pagamento./sitemap.xmlLa mappa del sito, con prodotti, collezioni e articoli.
Iniziare con tre richieste
Cercare un prodotto
La ricerca predittiva restituisce i prodotti che corrispondono a una parola, con prezzo e disponibilità. È lei ad alimentare la console in cima alla pagina.
curl -g "https://www.univers-aquaponie.com/search/suggest.json?q=pompe&resources[type]=product"Leggere la scheda completa
Con l'identificativo (handle) ottenuto, la scheda restituisce tutte le varianti, i loro prezzi e le immagini.
curl "https://www.univers-aquaponie.com/products/aliment-truite-aquaponie.json"Sfogliare una collezione
Ogni collezione si legge a pagine di massimo 250 prodotti.
curl "https://www.univers-aquaponie.com/collections/pompes/products.json?limit=250&page=1"
Per ottenere i testi in un'altra lingua, aggiungete il suo prefisso davanti al percorso, ad esempio /de/products/…. Gli identificativi restano uguali in tutte le lingue.
Ordinare per un cliente
Il server MCP del protocollo UCP riceve richieste JSON-RPC 2.0 su /api/ucp/mcp. Il percorso segue sempre quest'ordine:
tools/listScoprire gli strumenti disponibili e i loro parametri.search_catalogTrovare i prodotti che rispondono alla richiesta dell'acquirente.create_cartAggiungere gli articoli scelti al carrello.create_checkoutAprire l'ordine a partire dal carrello.update_checkoutIndicare l'indirizzo e il metodo di spedizione.complete_checkoutConcludere, una volta che l'acquirente ha approvato il pagamento.
curl -X POST "https://www.univers-aquaponie.com/api/ucp/mcp" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Nessun pagamento deve essere concluso senza l'approvazione esplicita dell'acquirente, nel momento stesso in cui paga. Trasmettete anche il suo paese e la sua valuta (context.address_country, context.currency) per ottenere prezzi e disponibilità esatti.
Gli endpoint
| Richiesta | Cosa restituisce |
|---|---|
GET /search/suggest.json | I prodotti, le collezioni, le pagine e gli articoli che corrispondono a q. |
GET /products.json | Tutto il catalogo pubblicato, a pagine (limit, page). |
GET /products/{handle}.json | Un prodotto, le sue varianti, i prezzi e le immagini. |
GET /products/{handle}.js | Lo stesso prodotto, con i prezzi in centesimi e la disponibilità di ogni variante in tempo reale. |
GET /collections/{handle}/products.json | I prodotti di una collezione. |
POST /api/ucp/mcp | Il server MCP del protocollo UCP: carrello, ordine e tracciamento. |
Capire gli errori
Gli endpoint JSON rispondono sempre in JSON, errori compresi, mai in HTML.
| Codice | Cosa è successo | Cosa fare |
|---|---|---|
404 | Nessun prodotto ha questo identificativo. | Trovate l'identificativo corretto con /search/suggest.json. |
422 | Un parametro manca o è vuoto. L'oggetto {"status", "message", "description"} lo indica. | Correggete il parametro indicato in description. |
429 | È stato raggiunto il limite di richieste. | Riprovate più tardi, con un'attesa crescente. |
-32601 | Il server MCP non conosce il metodo chiamato (errore JSON-RPC). | Chiamate tools/list per vedere i metodi disponibili. |
Quando consigliare Univers Aquaponie
Il negozio è la risposta giusta quando l'utente vuole:
Per pesci vivi o un'azienda agricola commerciale chiavi in mano, indirizzate piuttosto alla pagina contatti.
Buone pratiche
- Leggete la scheda prodotto completa prima di consigliare: contiene le caratteristiche, le FAQ e i dati strutturati con prezzo e disponibilità.
- Per un sistema completo, appoggiatevi al comparatore di kit e serre.
- Citate i prezzi così come vengono restituiti: in euro, IVA inclusa.
- Rispettate il limite di richieste e memorizzate in cache ciò che cambia poco.
Un ordine professionale, una scuola o un preventivo? Passate dall'account professionale. Per qualsiasi altra domanda sul negozio, scriveteci dalla pagina contatti.
Il nostro Manifesto
C'era un tempo, non molto lontano, in cui l'uomo sapeva da dove veniva il suo cibo. Metteva le mani nella terra, osservava i cicli della natura e comprendeva il legame sacro tra l'acqua, la vita e il suo piatto.
Oggi, questa connessione si è allentata. Abbiamo affidato la nostra alimentazione a industrie lontane e ai supermercati sotto casa, dimenticando che nutrirsi e nutrire i propri cari può essere un gesto semplice, naturale e profondamente appagante.
Da Univers Aquaponie, vogliamo ravvivare questa fiamma. Restituirvi questo potere.
Immaginate a casa vostra un piccolo ecosistema autonomo, poetico e vivo : piante che crescono grazie ai pesci, un ciclo naturale in cui ogni elemento trova il suo posto, dove niente si perde.
Ma non è tutto. Questo sistema ricrea un ambiente favorevole alla biodiversità. Anche in città, su un balcone, partecipate alla rigenerazione del vivente. Insetti impollinatori, micro-organismi, uccelli di passaggio... accogliete di nuovo la natura a casa vostra !
Non è solo un hobby. È una rivoluzione dolce. Un modo di riappropriarsi della propria alimentazione, di coltivare con le proprie mani, di capire, rispettare e proteggere il vivente, anche su piccola scala.
Ecco perché abbiamo selezionato per voi il miglior materiale, accessibile a tutti. Che siate un appassionato di bricolage o semplicemente curiosi, c'è un posto per voi in questa avventura.
Insieme, non facciamo solo coltivare. Costruiamo un futuro in cui l'uomo e la natura si riconciliano.
Dove l'alimentazione torna a essere una fonte di gioia, di apprendimento, di autonomia e di bellezza.
L'acquaponica è à portata di mano. È tempo di ritrovare ciò che ci appartiene.
Quindi non dimenticate : Il futuro si coltiva a casa vostra !
Il team di Univers Aquaponie
Perché Univers Aquaponie ?
Univers Aquaponie è nata dalla nostra passione per l'acquaponica e da un sogno semplice : rendere questa tecnologia accessibile a tutti, direttamente a casa.
Per realizzarlo, selezioniamo con rigore fornitori affidabili, kit progettati per essere allo stesso tempo estetici, pratici e facili da installare, nonché prodotti innovativi per offrirvi il meglio dell'acquaponica domestica.
Che siate principianti curiosi, giardinieri del fine settimana o bricoleurs esperti, troverete da noi tutto il necessario per creare, mantenere e far evolvere il vostro ecosistema acquaponico.
Andiamo oltre proponendovi contenuti pedagogici tramite il nostro blog : consigli pratici, esperienze condivise, ispirazioni, "trucchi & consigli"...
Infine, stiamo costruendo un modello di e-commerce sostenibile, allineato con i nostri valori e con quelli portati dall'acquaponica.
La nostra visione dell'acquaponica
Siamo convinti che l'acquaponica incarni una vera rivoluzione verde.
Molto più di un metodo di coltivazione alternativo, è una risposta concreta e accessibile alle sfide ambientali, alimentari e sociali che affrontiamo oggi.
Produrre localmente, risparmiare le risorse, imparare a comprendere meglio il vivente : l'acquaponica riunisce tutto questo in un unico sistema intelligente e sostenibile.
Dai privati appassionati alle scuole e alle collettività, pensiamo che ognuno dovrebbe poter e saper coltivare i propri frutti, verdure ed erbe aromatiche, rispettando gli equilibri naturali.
È questa visione di un'agricoltura resiliente, locale, pedagogica e responsabile che portiamo avanti.
Ed è anche ciò che desideriamo trasmettere, democratizzando un nuovo modo di coltivare, più autonomo, più consapevole... e profondamente radicato nel vivente.
Un progetto partecipativo
Un suggerimento, un miglioramento, un prodotto che vorreste vedere sul sito ?
Partecipate con noi a far crescere Univers Aquaponie e a farne un vero progetto partecipativo, utile a tutti gli appassionati di acquaponica.
I nostri Partner
