È 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 provider di servizi di Commerce Portal.

Come generare un token API

In qualità di utente Amministratore è possibile genere un token API nelle impostazioni del proprio profilo.

  1. Sulla barra degli strumenti di Commerce Portal espandere il menu a discesa accanto al proprio nome utente e fare clic su Profilo.
  2. Per generare un token API, fare clic su GENERA TOKEN.
  3. Selezionare la data di scadenza del token e fare clic su GENERA TOKEN.
  4. Copiare o salvare il token generato e fare clic su CONTINUA.

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"