Commerce Portal API를 사용하여 계약, 사용자 및 MBO(월별 청구 주문)에 대한 정보를 가져올 수 있습니다. MBO를 제출할 수도 있습니다. Commerce Portal API와 상호 작용하려면 Commerce Portal API 토큰을 생성하고 전달자 토큰으로 교환합니다.

Commerce Portal API를 사용하여 수행할 수 있는 작업에 대한 자세한 내용은 Commerce Portal Cloud Services Provider API 참조 및 설명서를 참조하십시오.

API 토큰을 생성하려면 어떻게 해야 합니까?

관리자 사용자는 프로파일 설정에서 API 토큰을 생성합니다.

  1. Commerce Portal 도구 모음에서 사용자 이름 옆에 있는 드롭다운 메뉴를 확장하고 프로파일을 클릭합니다.

  2. 액세스 토큰으로 이동한 후 토큰 생성을 클릭합니다.

  3. 토큰 이름을 입력하고 만료 날짜 및 역할을 선택한 다음, 생성을 클릭합니다.

  4. 생성된 토큰을 복사하거나 저장하고 닫기를 클릭합니다.

토큰이 생성되고 활성 토큰 목록에 표시됩니다.

토큰을 해지하거나 만료 날짜를 변경하려면 세로 줄임표 버튼(세로 줄임표 버튼)을 클릭하고 옵션 중 하나를 선택합니다.

API 토큰을 전달자 토큰으로 교환하려면 어떻게 해야 합니까?

Commerce Portal API에 대해 인증된 요청을 수행하려면 API 토큰을 전달자 토큰으로 교환해야 합니다.

인증 API를 호출하고 API 토큰을 전달자 토큰으로 교환합니다.

curl https://vcp.vmware.com/api/commerce/v1/auth \
-H 'Content-Type:application/json' \
-d '{"type":"UserToken","userToken":"yourAPIToken"}'

응답은 "accessToken" 매개 변수에서 전달자 토큰을 반환합니다.

{
 "tokenType":"bearer",
 "accessToken":"eyJhbGciOiJIUzUxMiJ9.
eyJhdWQiOiJTRVNTSU9OIiwiY29udGV4dCI6IjZmYWExZDM2LTE2NTUtNGY4Ny04ZWE3LWU0NGI0ZTM1MzQ2\
 MSIsImlhdCI6MTY1NDgzODc2NSwiZXhwIjoxNjU0ODQwNTY1fQ.
W9UCFRPNLpJK1JHKiBSODdjdyRqSBhq6jq7y5JkccmV5Gsw34zXrwiZcFECmhorvk5XW4Ow-1e0zGSR_if8AEQ",
 "expiresIn":1800
}

후속 API 요청에서 전달자 토큰을 사용하려면 어떻게 해야 합니까?

전달자 토큰을 가져온 후에는 이를 HTTP "Authorization" 헤더로 설정하여 후속 API 요청을 승인합니다. 올바른 형식은 "Authorization: Bearer your_accessToken"입니다.

아래 예에서는 전달자 토큰이 GET 요청에 사용되는 방식을 보여 줍니다.

curl https://vcp.vmware.com/api/provider/v1/contracts \
-H "Accept: application/json" \
-H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.
eyJhdWQiOiJTRVNTSU9OIiwiY29udGV4dCI6IjZmYWExZDM2LTE2NTUtNGY4Ny04ZWE3LWU0NGI0ZTM1MzQ2MSIsImlhdCI6MTY1NDgzODc2NSwi
ZXhwIjoxNjU0ODQwNTY1fQ.W9UCFRPNLpJK1JHKiBSODdjdyRqSBhq6jq7y5JkccmV5Gsw34zXrwiZcFECmhorvk5XW4Ow-1e0zGSR_if8AEQ"