Le tue prime richieste API

Inizia con le richieste di sola lettura per verificare la connettività, le credenziali e il contesto del team. Hai bisogno di CLI e, per il flusso bearer documentato, l’accesso come amministratore al team selezionato.

Controlla lo stato pubblico del servizio

curl --fail-with-body https://api.adios.dev/v1/health

Questa richiesta non necessita di autenticazione. Una risposta riuscita sullo stato verifica il percorso dell’API pubblica; non verifica il tuo account o la distribuzione nell’ambiente di esecuzione.

Imposta le tue credenziali private

Usa Autenticazione API per ottenere un token diagnostico, poi inseriscilo senza registrarne il valore nella cronologia della shell. Per bash:

export ADIOS_API_URL=https://api.adios.dev
export ADIOS_TEAM_ID=YOUR_TEAM_ID
read -r -s -p 'Access token: ' ADIOS_ACCESS_TOKEN
export ADIOS_ACCESS_TOKEN

Sostituisci YOUR_TEAM_ID sul team selezionato nella CLI. Il token deve appartenere allo stesso team.

Controlla la tua identità e le tue risorse

curl --fail-with-body "$ADIOS_API_URL/v1/auth/me" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

curl --fail-with-body "$ADIOS_API_URL/v1/workload?page=1&per_page=20" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

curl --fail-with-body "$ADIOS_API_URL/v1/team/deployment-context" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Verifica la tua identità, le risorse del team e il contesto di distribuzione disponibile. Usa gli ID delle risorse restituiti e le regioni disponibili nelle richieste successive. Non inventare un ID dagli esempi sintetici.

Rimuovi la variabile temporanea del token al termine della sessione:

unset ADIOS_ACCESS_TOKEN

Per il lavoro abituale, preferisci un archivio di segreti del client. Per Postman, segui la configurazione delle raccolte. Analizza uno stato di errore usando errori e paginazione.