Accesso via API

Interroga nxbase in modo programmatico con un token personale che crei nella tua pagina account. Il token agisce col tuo accesso: gli admin vedono tutto l'hostato, i member la proiezione pubblica.

Base URL

https://enextgen.it/nxbase-api

Autenticazione

Invia il token come header Bearer:

Authorization: Bearer nxb_your_token_here

Endpoint

• GET /data — righe JSON (paginato)
• GET /data.csv — tutte le righe filtrate in CSV
• GET /health — liveness (senza auth)

Filtri (multi-valore): parameter, source, commodity, activity, flow, site, period, unit… più sort, dir, page, limit.

Esempi

curl:

curl -H "Authorization: Bearer nxb_xxx" \
  "https://enextgen.it/nxbase-api/data.csv?parameter=Import%20mix&period=2024"

Python (pandas):

import io, requests, pandas as pd

r = requests.get(
    "https://enextgen.it/nxbase-api/data.csv",
    params={"parameter": "Total output", "source": "EMBER generation 2025"},
    headers={"Authorization": "Bearer nxb_xxx"},
)
df = pd.read_csv(io.StringIO(r.text))

Gestire i token

Crea, elenca e revoca i token nella tua pagina account. Il token completo si vede una sola volta, alla creazione — salvalo allora. Un token revocato smette di funzionare subito.