웹 서비스용 IBM MaaS360 API 참조

MaaS360®을 사용하면 관리자가 IBM® MaaS360 포털 사용자 인터페이스에서 웹 서비스 API에 액세스할 수 있습니다. IBM 지원팀에 문의하여 MaaS360 계정에서 이 기능을 사용하도록 설정하세요.

웹 서비스의 API 참조에는 구현 참고, API를 실행하는 데 필요한 속성, 액세스 제어 세부사항, 모델 예제를 포함하는 응답 클래스, 매개변수 세부사항과 같은 세부사항이 포함됩니다.

웹 서비스 API 내게 필요한 옵션 권한

MaaS360에는 IBM MaaS360 포털에서 웹 서비스 API에 액세스하는 두 가지 유형의 접근성 권한이 포함되어 있습니다. 서비스 관리자 역할이 있는 관리자 계정에 적절한 웹 서비스 API 내게 필요한 옵션 권한을 지정하십시오.

  • 읽기 액세스: 관리자는 IBM MaaS360 포털에서 웹 서비스 API 설명서를 볼 수 있습니다. 읽기 액세스 권한이 있는 비즈니스 관리자(BU) 계정이 제공됩니다.
  • 관리자 액세스: 관리자는 IBM MaaS360 포털에서 웹 서비스 API 설명서를 보고 샘플을 확인할 수 있습니다. 관리 액세스 권한이 있는 고객 관리자 계정이 제공됩니다.

관리자에게 지정된 액세스 권한 유형에 따라 관리자 계정에 대한 웹 서비스 API의 내게 필요한 옵션 레벨이 달라집니다.

IBM MaaS360 포털에서 웹 서비스 API 가용성

적절한 접근성 역할이 있는 관리자는 IBM MaaS360 포털에서 웹 서비스 API에 액세스할 수 있습니다. 설정 > 웹 서비스 API 로 이동한 후 문서 를 클릭하여 포털에서 웹 서비스 API를 보거나 실행하십시오.

관리자 액세스 권한이 있는 관리자 계정은 체험하기 옵션을 사용하여 웹 서비스 API를 실행할 수 있습니다.

참고: MaaS360 웹 서비스 API는 TLS 버전 1.1 이상을 지원합니다.

IBM MaaS360 포털에서 웹 서비스 API 실행 단계

  1. 설정 > 웹 서비스 API에서 문서를 클릭하십시오.
  2. 인증 API로 이동하고 고객 청구 ID 및 본문 매개변수를 입력하십시오.
  3. 체험하기를 클릭하여 인증 토큰을 생성하십시오.
    참고: 응답 본문에서 생성된 인증 토큰을 복사하여 MaaS360 웹 서비스 API를 사용해 보십시오. 토큰을 생성한 후 토큰은 60분 동안 유효합니다.
  4. MaaS360의 IBM MaaS360 포털 웹 서비스 API로 이동하여 다음 세부 정보를 입력합니다:
    • 청구 ID와 같이 API를 사용해야 하는 모든 필수 매개변수.
    • 3단계에서 생성한 인증 토큰.
      참고: 인증 토큰 값은 따옴표로 묶어 입력하고 접두부 MaaS token=을 사용해야 합니다. 예를 들어, MaaS token="xxxxxx"입니다.
  5. 체험하기를 클릭하여 웹 서비스 API를 사용해보십시오. 요청 URL, 응답 본문, 응답 코드, 응답 헤더가 웹 서비스 API에 대해 표시됩니다.
    참고: 응답 컨텐츠 유형은 기본적으로 application/XML입니다. 응답 컨텐츠 유형이 JSON 형식인 경우 application/json을 선택하십시오.