Autenticazione

ArchiCore utilizza chiavi API per l'autenticazione.

Ottenere una Chiave API

1. Accedi a ArchiCore
2. Vai su Impostazioni → Sviluppatore
3. Clicca su Genera Chiave API
4. Copia e conserva la tua chiave in modo sicuro

warning

Le chiavi API vengono mostrate solo una volta. Conservale in modo sicuro!

Utilizzare la Chiave API

Includi la chiave nell'header Authorization:

curl -H "Authorization: Bearer sk_live_xxxxx" \
  https://api.archicore.io/api/v1/projects

O come parametro di query (non raccomandato):

curl "https://api.archicore.io/api/v1/projects?api_key=sk_live_xxxxx"

Tipi di Chiave

Prefisso	Tipo	Descrizione
sk_live_	Produzione	Accesso completo al tuo account
sk_test_	Test	Accesso limitato, per sviluppo

Permessi della Chiave

Le chiavi API ereditano i permessi dal livello del tuo account:

Permesso	Gratuito	Pro	Enterprise
Leggere progetti	✓	✓	✓
Creare progetti	✓	✓	✓
Analisi	✓	✓	✓
Webhooks	-	✓	✓
Accesso team	-	-	✓

Revocare le Chiavi

Per revocare una chiave API:

1. Vai su Impostazioni → Sviluppatore
2. Trova la chiave nell'elenco
3. Clicca su Revoca

Le chiavi revocate smettono immediatamente di funzionare.

Best Practice di Sicurezza

1. Non committare mai chiavi API nel controllo versione
2. Usa variabili d'ambiente per memorizzare le chiavi
3. Ruota le chiavi regolarmente (raccomandato: ogni 90 giorni)
4. Usa chiavi di test per lo sviluppo
5. Monitora l'utilizzo nella dashboard

Variabili d'Ambiente

# .env (aggiungi a .gitignore!)
ARCHICORE_API_KEY=sk_live_xxxxx

const client = new ArchiCore({
  apiKey: process.env.ARCHICORE_API_KEY
});

OAuth (Prossimamente)

Il supporto OAuth 2.0 è previsto per le integrazioni di team.