Autenticazione
Ogni chiamata API richiede una credenziale. Usa una chiave API per servizi e script, o un token bearer OAuth/OIDC per i flussi utente.
QuantumAPI accetta due tipi di credenziale. Le chiavi API sono per i tuoi backend, script, job CI e la CLI. I token di accesso OAuth 2.0 / OIDC sono per gli utenti autenticati e per le applicazioni di servizio che usano il flusso client-credentials. Scegline una per richiesta.
Chiavi API (header X-Api-Key)
Crea una chiave nel portale in Keys → API Keys e inviala nell'header X-Api-Key a ogni richiesta. La chiave da sola basta: nessuno scambio di token, nessuna sessione, nessuna seconda credenziale.
curl https://api.quantumapi.eu/api/v1/secrets \
-H "X-Api-Key: $QAPI_API_KEY"- Le chiavi iniziano con
qapi_sk_(segreta) oqapi_pk_(pubblicabile). La chiave completa viene mostrata una sola volta: conservala nel tuo vault o nel secret store della CI. - URL di base:
https://api.quantumapi.eu/api/v1. - La chiave identifica la tua organizzazione, quindi non serve inviare un header di tenant.
Authorization: Bearer .... Le chiavi API vengono lette solo dall'header X-Api-Key; l'header Authorization: Bearer è riservato ai token di accesso OAuth/OIDC.Scope
Ogni chiave porta un elenco di scope come secrets:read, keys:write, encrypt o qrng:read. Assegna a una chiave solo gli scope necessari all'applicazione: una chiave creata senza scope selezionati li riceve tutti. Una chiamata senza lo scope giusto restituisce 403:
{
"error": "insufficient_scope",
"message": "The API key does not have the required scope 'secrets:read'.",
"details": { "required_scope": "secrets:read" }
}Token bearer OAuth 2.0 / OIDC
Per l'accesso degli utenti (authorization code con PKCE) e per l'accesso machine-to-machine, richiedi un token di accesso al server di identità QuantumID e invialo come Authorization: Bearer <token>. L'esempio usa un'applicazione di servizio e il flusso client-credentials.
# 1. Exchange the client credentials of a service application for an access token
curl -X POST https://auth.quantumapi.eu/connect/token \
-d "grant_type=client_credentials" \
-d "client_id=$QAPI_CLIENT_ID" \
-d "client_secret=$QAPI_CLIENT_SECRET" \
-d "scope=api"
# 2. Send the access_token from the response as a Bearer token
curl https://api.quantumapi.eu/api/v1/secrets \
-H "Authorization: Bearer $ACCESS_TOKEN"| Caso d'uso | Credenziale | Header |
|---|---|---|
| Backend, script, job CI, CLI | Chiave API | X-Api-Key: qapi_sk_... |
| Applicazione di servizio (machine-to-machine) | Token di accesso da client_credentials | Authorization: Bearer <token> |
| Utente autenticato (web, mobile) | Token di accesso da authorization code + PKCE | Authorization: Bearer <token> |
https://auth.quantumapi.eu/.well-known/openid-configuration; l'endpoint dei token è /connect/token.