Inizia con le API

Quickstart API

Ottieni un token e interroga le API in pochi passaggi
View as Markdown

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

1

Recupera le credenziali

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

2

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.

3

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:

1{
2  "active": 128,
3  "ko": 2,
4  "delivering": 11
5}

JavaScript

1const response = await fetch("https://api.eis.it/v1/circuits/stats/count", {
2  headers: {
3    Accept: "application/json",
4    Authorization: `Bearer ${process.env.EIS_ACCESS_TOKEN}`,
5  },
6});
7
8if (!response.ok) {
9  throw new Error(`Hive API: HTTP ${response.status}`);
10}
11
12console.log(await response.json());

Python

1import os
2import requests
3
4response = requests.get(
5    "https://api.eis.it/v1/circuits/stats/count",
6    headers={
7        "Accept": "application/json",
8        "Authorization": f"Bearer {os.environ['EIS_ACCESS_TOKEN']}",
9    },
10    timeout=30,
11)
12response.raise_for_status()
13print(response.json())

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