Quickstart API

Ottieni un token e interroga le API in pochi passaggi

Questa guida usa GET /v1/circuits/stats/count come prima richiesta autenticata.

Recupera le credenziali

Genera l’API key in Hive da Profilo utente > API Keys. Riceverai un clientId e un clientSecret.

Ottieni un access token

curl --request POST \
  --url "https://api.eis.it/auth/api-key/login" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "clientId=$EIS_CLIENT_ID" \
  --data-urlencode "clientSecret=$EIS_CLIENT_SECRET"

Leggi il campo access_token dalla risposta JSON.

Invia una richiesta autenticata

curl --request GET \
  --url "https://api.eis.it/v1/circuits/stats/count" \
  --header "Authorization: Bearer $EIS_ACCESS_TOKEN" \
  --header "Accept: application/json"

La risposta 200 contiene i contatori dei circuiti:

{
  "active": 128,
  "ko": 2,
  "delivering": 11
}

JavaScript

const response = await fetch("https://api.eis.it/v1/circuits/stats/count", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${process.env.EIS_ACCESS_TOKEN}`,
  },
});
if (!response.ok) {
  throw new Error(`Hive API: HTTP ${response.status}`);
}
console.log(await response.json());

Python

import os
import requests
response = requests.get(
    "https://api.eis.it/v1/circuits/stats/count",
    headers={
        "Accept": "application/json",
        "Authorization": f"Bearer {os.environ['EIS_ACCESS_TOKEN']}",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

Per i parametri e le risposte degli altri endpoint consulta la reference completa.