API

Come forniamo e distribuiamo i dati

wwwine espone i dati dell’archivio italiano tramite API REST in lettura. L’obiettivo è dare a redazioni, tool interni, app e ricercatori un accesso stabile a produttori, vini e metadati territoriali — senza dover raschiare il sito.

Come forniamo i dati

  • Endpoint JSON su base HTTPS, autenticati con chiave API (header Authorization: Bearer …).
  • Risorse principali: /v1/produttori, /v1/produttori/:slug, /v1/vini, /v1/vini/:id, con filtri per regione, uvaggio e testo.
  • Paginazione cursor-based e limiti per richiesta, per scarichi ordinati senza sovraccaricare il servizio.
  • Campi tipizzati: nome, sede, sito, contatti pubblici, etichette, colore/stile, flag di pratica quando dichiarati.

Come li distribuiamo

  • Piani di accesso: prova gratuita a quota ridotta; piani editoriali e commerciali con rate limit dedicati.
  • Export periodici (opzionali) in JSON/CSV delle variazioni, per chi sincronizza un data warehouse.
  • Provenienza: ogni record può indicare livello di verifica; non vendiamo contatti personali non pubblici.
  • Ambito: per ora solo Italia in risposta pubblica; dataset esteri restano esclusi dalle API esposte.

Le API sono in preparazione. Per accesso early o partnership scrivi a api@wwwine.it.