Autenticazione

Tutte le richieste API richiedono una API key valida nell’header Authorization.

Ottenere la tua API key

Vai su Settings > API nella dashboard di Finseo
Clicca su Create API Key
Scegli un nome, gli scope e, facoltativamente, limita l’accesso a progetti specifici
Copia subito la chiave: verrà mostrata una sola volta

Usare la tua chiave

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.finseo.ai/v1/projects

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(
    "https://api.finseo.ai/v1/projects",
    headers=headers
)

const response = await fetch("https://api.finseo.ai/v1/projects", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

Verificare una chiave

GET /v1/me restituisce l’account a cui appartiene una chiave. Usalo per verificare che una chiave sia valida, mostrare agli utenti quale account hanno collegato e leggere gli scope della chiave: risponde indipendentemente dal fatto che l’account abbia già dei progetti, il che lo rende l’endpoint giusto per le integrazioni e i test di connessione.

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.finseo.ai/v1/me

{
  "data": {
    "id": "6a81e088f8ef06e062c40633",
    "email": "you@example.com",
    "accountName": "Your Company",
    "tier": "Business",
    "projectCount": 1,
    "scopes": ["read", "write"],
    "environment": "live"
  }
}

Una chiave non valida o revocata restituisce 401 con il codice di errore UNAUTHORIZED.

Scope

Le API key possono avere uno o più scope:

Scope	Descrizione
`read`	Leggere dati (progetti, prompt, metriche, competitor, fonti)
`write`	Modificare dati (creare prompt, aggiornare tag, gestire progetti)
`export`	Esportare in blocco i dati di tracking

Restrizioni per progetto

Puoi facoltativamente limitare una chiave a progetti specifici. Una chiave senza restrizioni di progetto può accedere a tutti i progetti del tuo account.

Sicurezza della chiave

Non esporre mai le API key nel codice lato client o in repository pubblici.

Le chiavi vengono sottoposte ad hashing con SHA-256 prima dell’archiviazione: non memorizziamo mai il testo in chiaro
Ruota le chiavi regolarmente e revoca immediatamente quelle compromesse
Usa chiavi di test per lo sviluppo e chiavi live per la produzione

Panoramica

Per iniziare

Analytics

Autenticazione API e chiavi API

Autenticazione

Ottenere la tua API key

Usare la tua chiave

Verificare una chiave

Scope

Restrizioni per progetto

Sicurezza della chiave

​Autenticazione

​Ottenere la tua API key

​Usare la tua chiave

​Verificare una chiave

​Scope

​Restrizioni per progetto

​Sicurezza della chiave

Autenticazione

Ottenere la tua API key

Usare la tua chiave

Verificare una chiave

Scope

Restrizioni per progetto

Sicurezza della chiave