API dati WAW

API REST che restituiscono JSON. Le rotte pubbliche non richiedono autenticazione e hanno un limite di frequenza per indirizzo IP. Le rotte statistiche e di export richiedono una chiave rilasciata su richiesta motivata.

Autenticazione

Authorization: Bearer waw_xxxxxxxxxxxxxxxxxxxxxxxx

Le chiavi si richiedono scrivendo alla redazione, indicando ente, referente e finalita. Ogni chiave ha scope (stats:read, export) e quota oraria.

Endpoint pubblici

GET https://www.wawsafari.com/api/v1/search?q=lupo
GET https://www.wawsafari.com/api/v1/species?q=cervo
GET https://www.wawsafari.com/api/v1/species/{slug}
GET https://www.wawsafari.com/api/v1/map/observations?bbox=10,43,12,44&zoom=9
GET https://www.wawsafari.com/api/v1/observations/{code}
GET https://www.wawsafari.com/api/v1/geo/regions
GET https://www.wawsafari.com/api/v1/geo/reverse?lat=43.77&lng=11.25
GET https://www.wawsafari.com/api/v1/habitats

Endpoint statistici (chiave richiesta)

GET /api/v1/stats/summary
GET /api/v1/stats/species?region_id=9&from=2024-01-01
GET /api/v1/stats/phenology?species=lupo
GET /api/v1/stats/grid?species=lupo&cell=10km
GET /api/v1/stats/habitat?category_id=1

Export

GET /api/v1/export/observations.csv?region_id=9
GET /api/v1/export/observations.geojson?species=lupo
GET /api/v1/export/observations.dwca?year=2025

Il formato dwca produce un Darwin Core Archive completo di occurrence.txt, meta.xml ed eml.xml, direttamente pubblicabile su GBIF.

Limite sincrono: 50.000 record. Oltre questa soglia usa la richiesta di export asincrono.

Parametri comuni

Parametro	Descrizione
`species` / `species_id`	slug o id della specie
`category_id`	categoria faunistica
`region_id`, `province_id`	ambito amministrativo
`protected_area_id`	area protetta
`habitat_id`, `land_cover`	ambiente
`from`, `to`, `year`	intervallo temporale
`season`, `solar_phase`	stagione, fase della giornata
`quality`	`research` \| `all`
`bbox`	minLng,minLat,maxLng,maxLat

Regole invarianti

Le specie sensibili escono sempre con coordinate generalizzate a 10 km e i campi informationWithheld e dataGeneralizations valorizzati.
Ogni risposta include un blocco meta con licenza, attribuzione, data di generazione e filtri applicati.
Le identificazioni non verificate sono incluse ma marcate: leggere sempre quality_grade e identificationVerificationStatus prima di qualunque analisi.

Licenza e citazione

I dati sono rilasciati con licenza CC-BY-NC-4.0. Citazione richiesta: WAW - Wild Animal Watching, archivio rilevazioni di fauna italiana, consultato il [data], https://www.wawsafari.com/scienza.