하드웨어 dashboard API

  • 아티클

Microsoft 하드웨어 API를 사용하여 organization 파트너 센터 계정 내에서 하드웨어 제품에 대한 제출을 프로그래밍 방식으로 쿼리하고 만듭니다. 이러한 API는 계정이 많은 제품을 관리하고 이러한 자산에 대한 제출 프로세스를 자동화하고 최적화하려는 경우에 유용합니다. 이러한 API는 Microsoft Entra ID(Microsoft Entra ID)를 사용하여 앱 또는 서비스의 호출을 인증합니다. 다음 단계에서는 Microsoft 하드웨어 API를 사용하는 엔드투엔드 프로세스를 설명합니다.

  1. 이러한 API는 하드웨어 파트너 센터 프로그램에 속한 계정에서만 사용할 수 있습니다.

  2. 아래 필수 구성 요소를 완료했는지 확인합니다.

  3. Microsoft 하드웨어 API에서 메서드를 호출하기 전에 아래 그림과 같이 Microsoft Entra ID 액세스 토큰을 가져옵니다. 토큰을 가져온 후 만료되기 전에 이 토큰을 Microsoft Store 제출 API에 대한 호출에 사용할 수 있는 시간은 60분입니다. 토큰이 만료된 후 새 토큰을 생성할 수 있습니다.

  4. Microsoft 하드웨어 API를 호출합니다.

Microsoft 하드웨어 API 사용을 위한 필수 구성 요소 완료

Microsoft 하드웨어 API를 호출하는 코드 작성을 시작하기 전에 다음 필수 구성 요소를 완료했는지 확인합니다.

Microsoft Entra ID 애플리케이션에 적절한 하드웨어 역할 할당

위의 필수 구성 요소를 완료한 후에는 이제 Microsoft Entra ID 애플리케이션이 제출 및 배송 레이블을 만들고 관리할 수 있도록 적절한 역할을 할당해야 합니다.

  1. 파트너 센터에서 기어 아이콘(dashboard 오른쪽 위 모서리 근처)을 선택한 다음 개발자 설정을 선택합니다. 설정 메뉴에서 사용자를 선택합니다.

  2. 사용자 페이지에서 파트너 센터 계정의 제출에 액세스하는 데 사용할 앱 또는 서비스를 나타내는 Microsoft Entra ID 애플리케이션 및 Microsoft Entra ID 애플리케이션을 선택합니다.

  3. 이 페이지의 역할에서 하드웨어를 선택합니다.

    역할 섹션의 하드웨어 탭을 보여 주는 이미지입니다.

    드라이버 제출자, 배송 레이블 소유자를 선택하고, 사용 가능한 경우 배송 레이블 프로모터를 선택합니다. 이러한 역할에 대해 자세히 알아보기

Microsoft Entra ID 액세스 토큰 가져오기

Microsoft 하드웨어 API에서 메서드를 호출하기 전에 먼저 API에서 각 메서드의 권한 부여 헤더에 전달하는 Microsoft Entra ID 액세스 토큰을 가져와야 합니다. 액세스 토큰을 얻은 후 만료되기 전에 60분 동안 사용할 수 있습니다. 토큰이 만료되면 토큰을 새로 고칠 수 있으므로 API에 대한 추가 호출에서 토큰을 계속 사용할 수 있습니다. 액세스 토큰을 가져오려면 클라이언트 자격 증명을 사용한 서비스 간 호출의 지침에 따라 HTTP POST를 https://login.microsoftonline.com/<tenant_id>/oauth2/token 끝점에 보냅니다. 다음은 샘플 요청입니다.

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com

POST URI의 tenant_id 값, client_id 및 client_secret 매개 변수에는 이전 섹션의 파트너 센터에서 검색한 애플리케이션의 테넌트 ID, 클라이언트 ID 및 키를 지정합니다. 리소스 매개 변수에는 https://manage.devcenter.microsoft.com을 지정해야 합니다.

액세스 토큰이 만료되면 액세스 토큰 새로 고침의 지침에 따라 새로 고칠 수 있습니다.

Microsoft 하드웨어 API 사용

Microsoft Entra ID 액세스 토큰이 있으면 Microsoft 하드웨어 API에서 메서드를 호출할 수 있습니다. API에는 시나리오로 그룹화된 많은 메서드가 포함되어 있습니다. 제출을 만들거나 업데이트하려면 일반적으로 Microsoft 하드웨어 API에서 특정 순서로 여러 메서드를 호출합니다. 각 시나리오와 각 메서드의 구문에 대한 자세한 내용은 다음 표의 문서를 참조하세요.

시나리오 Description
드라이버 파트너 센터 계정에 등록된 드라이버를 가져와서 만들고 업데이트합니다. 이러한 메서드에 대한 자세한 내용은 다음 문서를 참조하세요.

코드 예제

다음 샘플에서는 Microsoft Surface 및 디바이스 팀에서 만든 완전한 종단 간 미리 빌드된 솔루션과 함께 Microsoft 하드웨어 API를 사용하는 방법을 보여 주는 자세한 코드를 제공합니다.

하드웨어 dashboard API 샘플(GitHub)

Surface 개발자 센터 관리자 도구(GitHub)

추가 도움말

Microsoft Store 제출 API에 대한 질문이 있거나 이 API를 사용하여 제출을 관리하는 데 도움이 필요한 경우 지원 페이지를 방문하여 도움을 요청하세요.

Microsoft Entra ID란?