하드웨어 대시보드 API
Microsoft 하드웨어 API를 사용하여 조직의 파트너 센터 계정 내에서 하드웨어 제품에 대한 제출을 프로그래밍 방식으로 쿼리하고 만듭니다. 이러한 API는 계정이 많은 제품을 관리하고 이러한 자산에 대한 제출 프로세스를 자동화하고 최적화하려는 경우에 유용합니다. 이러한 API는 Microsoft Entra ID(Microsoft Entra ID)를 사용하여 앱 또는 서비스의 호출을 인증합니다. 다음 단계에서는 Microsoft 하드웨어 API를 사용하는 엔드투엔드 프로세스에 대해 설명합니다.
이러한 API는 하드웨어 파트너 센터 프로그램에 속한 계정에서만 사용할 수 있습니다.
아래 필수 구성 요소를 완료했는지 확인합니다.
Microsoft 하드웨어 API에서 메서드를 호출하기 전에 아래 그림과 같이 Microsoft Entra ID 액세스 토큰을 가져옵니다. 토큰을 가져온 후 만료되기 전에 이 토큰을 Microsoft Store 제출 API에 대한 호출에 사용할 수 있는 시간은 60분입니다. 토큰이 만료된 후 새 토큰을 생성할 수 있습니다.
Microsoft 하드웨어 API를 호출합니다.
Microsoft 하드웨어 API 사용을 위한 필수 구성 요소 완료
Microsoft 하드웨어 API를 호출하는 코드 작성을 시작하기 전에 다음 필수 구성 요소를 완료했는지 확인합니다.
사용자(또는 조직)에게는 Microsoft Entra ID 디렉터리가 있어야 하며 디렉터리에 대한 전역 관리자 권한이 있어야 합니다. 이미 Microsoft 365 또는 Microsoft의 다른 비즈니스 서비스를 사용하는 경우 이미 Microsoft Entra ID 디렉터리가 있습니다. 그렇지 않으면 추가 비용 없이 파트너 센터에서 새 Microsoft Entra ID를 만들 수 있습니다.
Microsoft Entra ID 애플리케이션이 아직 없는 경우 만들어야 합니다.
Microsoft Entra ID 애플리케이션을 파트너 센터 계정과 연결하고 관리자 역할을 할당해야 합니다.
Microsoft Entra ID 애플리케이션 테넌트 ID, 클라이언트 ID 및 키를 수집합니다. 키 만들기 페이지를 나가면 다시 액세스할 수 없으므로 이 키 정보를 인쇄하거나 복사해야 합니다.
Microsoft Entra ID 애플리케이션에 적절한 하드웨어 역할 할당
위의 필수 구성 요소를 완료한 후에는 Microsoft Entra ID 애플리케이션이 제출 및 배송 레이블을 만들고 관리할 수 있도록 적절한 역할을 할당해야 합니다.
파트너 센터에서 대시보드의 오른쪽 위 모서리 근처에 있는 기어 아이콘을 선택한 다음 개발자 설정을 선택합니다. 설정 메뉴에서 사용자를 선택합니다.
사용자 페이지에서 파트너 센터 계정의 제출에 액세스하는 데 사용할 앱 또는 서비스를 나타내는 Microsoft Entra ID 애플리케이션 및 Microsoft Entra ID 애플리케이션을 선택합니다.
이 페이지의 역할 아래에서 하드웨어를 선택합니다.
드라이버 제출자, 배송 레이블 소유자 및 사용 가능한 경우 배송 레이블 프로모터를 선택합니다. 이러한 역할에 대해 자세히 알아보기
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에서 특정 순서로 여러 메서드를 호출합니다. 각 시나리오 및 각 메서드의 구문에 대한 자세한 내용은 다음 테이블의 문서를 참조하세요.
| 시나리오 | 설명 |
|---|---|
| 드라이버 | 파트너 센터 계정에 등록된 드라이버를 가져와서 만들고 업데이트합니다. 이러한 메서드에 대한 자세한 내용은 다음 문서를 참조하세요. |
코드 예제
다음 샘플에서는 Microsoft Surface 및 디바이스 팀에서 만든 전체 엔드투엔드 미리 빌드된 솔루션과 함께 Microsoft 하드웨어 API를 사용하는 방법을 보여 주는 자세한 코드를 제공합니다.
추가 도움말
Microsoft Store 제출 API에 대한 질문이 있거나 이 API를 사용하여 제출을 관리하는 데 도움이 필요한 경우 지원 페이지를 방문하여 도움말을 요청하세요.