È possibile utilizzare l'API di Commerce Portal per ottenere informazioni su contratti, utenti e ordini di fatturazione mensili (MBO). È inoltre possibile inviare MBO. Per interagire con l'API di Commerce Portal, generare un token API in Commerce Portal e scambiarlo con un bearer token.
Per ulteriori informazioni sulle operazioni che è possibile eseguire utilizzando l'API di Commerce Portal, fare riferimento alla documentazione dell'API del Cloud Services Provider di Commerce Portal.
Come generare un token API
In qualità di utente Amministratore è possibile genere un token API nelle impostazioni del proprio profilo.
Sulla barra degli strumenti di Commerce Portal espandere il menu a discesa accanto al proprio nome utente e fare clic su Profilo.
Passare a Token di accesso e fare clic su GENERA TOKEN.
Immettere un nome per il token, selezionarne la data di scadenza e i ruoli, quindi fare clic su GENERA.
Copiare o salvare il token generato e fare clic su CHIUDI.
Il token viene generato e viene visualizzato nell'elenco dei token attivi.
Per revocare un token o modificarne la data di scadenza, fare clic sul pulsante puntini di sospensione verticali (
) e selezionare una delle opzioni.
Come scambiare un token API con un bearer token
Per poter creare richieste autorizzate all'API di Commerce Portal, è necessario scambiare il token API con un bearer token.
Chiamare l'API di autenticazione e scambiare il token API con un bearer token.
curl https://vcp.vmware.com/api/commerce/v1/auth \
-H 'Content-Type:application/json' \
-d '{"type":"UserToken","userToken":"yourAPIToken"}'
La risposta restituisce il bearer token nel parametro "accessToken".
{
"tokenType":"bearer",
"accessToken":"eyJhbGciOiJIUzUxMiJ9.
eyJhdWQiOiJTRVNTSU9OIiwiY29udGV4dCI6IjZmYWExZDM2LTE2NTUtNGY4Ny04ZWE3LWU0NGI0ZTM1MzQ2\
MSIsImlhdCI6MTY1NDgzODc2NSwiZXhwIjoxNjU0ODQwNTY1fQ.
W9UCFRPNLpJK1JHKiBSODdjdyRqSBhq6jq7y5JkccmV5Gsw34zXrwiZcFECmhorvk5XW4Ow-1e0zGSR_if8AEQ",
"expiresIn":1800
}
Come utilizzare il bearer token nelle richieste API successive
Dopo aver ottenuto il bearer token, impostarlo come intestazione "Authorization" HTTP per autorizzare le richieste API successive. Il formato corretto da utilizzare è "Authorization: Bearer your_accessToken".
L'esempio seguente mostra come viene utilizzato un bearer token in una richiesta GET.
curl https://vcp.vmware.com/api/provider/v1/contracts \ -H "Accept: application/json" \ -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9. eyJhdWQiOiJTRVNTSU9OIiwiY29udGV4dCI6IjZmYWExZDM2LTE2NTUtNGY4Ny04ZWE3LWU0NGI0ZTM1MzQ2MSIsImlhdCI6MTY1NDgzODc2NSwi ZXhwIjoxNjU0ODQwNTY1fQ.W9UCFRPNLpJK1JHKiBSODdjdyRqSBhq6jq7y5JkccmV5Gsw34zXrwiZcFECmhorvk5XW4Ow-1e0zGSR_if8AEQ"
