Pobieranie danych produktu

Użyj następujących metod w interfejsów API sprzętu firmy Microsoft, aby pobrać dane dla produktów sprzętowych zarejestrowanych na koncie Centrum deweloperów. Aby zapoznać się z wprowadzeniem do interfejsów API sprzętu firmy Microsoft oraz wymaganiami wstępnymi dotyczącymi ich użycia, zobacz Zarządzanie przesyłaniem sprzętu przy użyciu interfejsów API.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/

Aby można było użyć tych metod, produkt musi już istnieć na koncie Centrum dla deweloperów. Aby utworzyć zgłoszenia produktów lub zarządzać nimi, sprawdź metody opisane w Zarządzanie zgłoszeniami produktów.

Wymagania wstępne

Przed podjęciem próby użycia dowolnej z tych metod wykonaj wszystkie wymagania wstępne dla interfejsów API sprzętu firmy Microsoft.

Zasoby danych

Metody sprzętowych API firmy Microsoft do pobierania danych produktów korzystają z następujących danych JSON.

Zasób produktu

Ten zasób reprezentuje produkt sprzętowy (sterownik) zarejestrowany na Twoim koncie.

{
  "id": 9007199267351834,
  "sharedProductId": 1152921504606971100,
  "links": [
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/9007199267351834",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/9007199267351834/submissions",
      "rel": "get_submissions",
      "method": "GET"
    }
  ],
  "isCommitted": true,
  "isExtensionInf": false, "_comment": "This field is deprecated and moved to submission resource",
  "deviceMetadataIds": [],
  "deviceType": "notSet",
  "isTestSign": false,
  "isFlightSign": false,
  "marketingNames": [
    "marketing name 1",
    "marketing name 2"
],
  "productName": "product name",
  "selectedProductTypes": {
    "windows_v100Server": "Unclassified",
    "windows_v100": "Unclassified"
},
  "requestedSignatures": [
    "WINDOWS_v100_X64_TH1_FULL",
    "WINDOWS_v63_X64"
  ],
  "additionalAttributes": {},
  "testHarness": "hlk",
  "announcementDate": "2016-10-22T00:00:00Z",
}

Ten zasób ma następujące wartości

Zasób zgłoszeń

Ten zasób reprezentuje zgłoszenie produktu.

{
  "id": 1152921504621442000,
  "productId": 13635057453741328,
   "workflowStatus": {
      "currentStep": "finalizeIngestion",
      "state": "completed",
      "messages": []
    },
  "links": [
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/13635057453741329/submissions/1152921504621441944",
      "rel": "self",
      "method": "GET"
    }
  ],
  "commitStatus": "CommitPending",
  "isExtensionInf": true,
  "isUniversal": true,
  "isDeclarativeInf": true,
  "name": "HARRY-Duatest2",
  "type": "derived"
}

Ten zasób ma następujące wartości:

Obiekt Stan przepływu pracy

Ten obiekt reprezentuje stan przepływu pracy dla danej jednostki

{
      "currentStep": "finalizeIngestion",
      "state": "completed",
      "messages": []
    }

Ten obiekt ma następujące wartości

Pobierz obiekt

Ten obiekt reprezentuje pliki do pobrania dla danego przesłania.

{
  "items": [
    {
      "type": "initialPackage",
      "url": "<SAS URL from Hardware API>"
    },
    {
      "type": "derivedPackage",
      "url": "<SAS URL from Hardware API>"
    },
    {
      "type": "signedPackage",
      "url": "<SAS URL from Hardware API>"
    },
    {
      "type": "certificationReport",
      "url": "https:// manage.devcenter.microsoft.com/dashboard/hardware/Driver/DownloadCertificationReport/29963920/13635057453741329/1152921504621441930"
    }
  ],
  "messages": []
}

Ten obiekt ma następujące wartości

Obiekt łącza

Ten obiekt reprezentuje listę przydatnych linków dla jednostki zawierającej

{
      "href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/9007199267351834",
      "rel": "self",
      "method": "GET"
    }

Ten obiekt ma następujące wartości

Dodatkowy obiekt atrybutu

Ten obiekt zawiera więcej atrybutów produktu, jeśli jest to kontroler RAID, kontroler magazynu lub program weryfikacji wirtualizacji serwera (SVVP). Może zawierać jeden z trzech typów obiektów — StorageController, RaidController lub SVVP.

StorageController, obiekt

RaidController obiekt

Obiekt SVVP

Lista typów produktów

Produkt może być jednym z następujących typów. Wraz z systemem operacyjnym te informacje służą do identyfikowania stosowania.

• Drukarka 3D
• Czujnik akcelerometru
• Wszystko w jednym
• Urządzenie wielofunkcyjne z technologią dotykową
• Urządzenie audio
• Obiekty przetwarzania dźwięku
• Kontroler Bluetooth
• Kontroler Bluetooth bez portu USB
• Kamera
• Czujnik kamery
• Klaster
• Akcelerator obliczeniowy MCDM 2.7
• Akcelerator obliczeniowy MCDM 3.1
• Akcelerator obliczeniowy MCDM 3.2
• Tablet konwertowalny
• Pulpit nawigacyjny
• Program renderowania multimediów cyfrowych
• Serwer multimediów cyfrowych
• Cyfrowe aparaty fotograficzne
• Cyfrowe kamery wideo
• Urządzenia z włączoną obsługą zarządzania skanowaniem dystrybucji
• Drukarka wielofunkcyjna WSD dla przedsiębiorstw
• Czytnik odcisków palców
• Kontroler gry
• Kontroler ogólny
• Ogólne urządzenie przenośne
• Karta graficzna MCDM2.7
• Karta graficzna MCDM2.8
• Karta graficzna MCDM2.9
• Karta graficzna MCDM3.0
• Adapter graficzny WDDM1.0
• Adapter graficzny WDDM1.1
• Karta graficzna WDDM1.2
• Adapter graficzny WDDM1.2 Tylko wyświetlanie
• Adapter graficzny WDDM1.2 RenderOnly
• Adapter graficzny WDDM1.3
• Karta graficzna WDDM1.3 DisplayOnly
• Adapter graficzny WDDM1.3 RenderOnly
• Adapter graficzny WDDM2.0
• Adapter graficzny tylko do wyświetlania WDDM2.0
• Karta graficzna WDDM2.0 tylko do renderowania
• Adapter graficzny WDDM2.1
• Karta graficzna z obsługą wyświetlania tylko WDDM2.1
• Karta graficzna WDDM2.1 obsługująca tylko renderowanie
• Karta graficzna WDDM2.2
• Adapter graficzny WDDM2.2 tylko wyświetlacz
• Adapter graficzny WDDM2.2 tylko renderowanie
• Adapter graficzny WDDM2.3
• Adapter graficzny WDDM2.3, tylko do wyświetlania
• Karta graficzna WDDM2.3 tylko do renderowania
• Adapter graficzny WDDM2.4
• Adapter graficzny wyświetlania tylko WDDM2.4
• Karta graficzna do renderowania WDDM2.4
• Karta graficzna WDDM2.4
• Karta graficzna WDDM2.5
• Adapter graficzny WDDM2.5 wyłącznie do wyświetlania
• Karta graficzna Render Only WDDM2.5
• Maszyna wirtualna karty grafiki WDDM2.5
• Adapter graficzny WDDM2.6
• Adapter graficzny WDDM2.6 tylko do wyświetlania
• Tylko do renderowania karta graficzna WDDM2.6
• Karta graficzna WDDM2.6
• Karta graficzna WDDM2.7
• Tylko adapter graficzny wyświetlacza WDDM2.7
• Adapter graficzny WDDM2.7 tylko do renderowania
• Adapter graficzny WDDM2.7 VM
• Karta graficzna WDDM2.8
• Adapter graficzny WDDM2.8 wyłącznie do wyświetlania
• Adapter graficzny WDDM2.8 tylko do renderowania
• Adapter graficzny WDDM2.8
• Adapter graficzny WDDM2.9
• Karta graficzna WDDM2.9 Tylko wyświetlanie
• Karta graficzna WDDM2.9 tylko do renderowania
• Karta graficzna WDDM2.9 VM
• Karta graficzna WDDM3.0
• Karta graficzna wyłącznie do wyświetlania WDDM3.0
• Karta graficzna WDDM3.0, tylko renderowanie
• Adapter graficzny WDDM3.0 VM
• Karta graficzna WDDM3.1
• Sterownik wyświetlacza WDDM3.1 tylko dla karty graficznej
• Adapter graficzny WDDM3.1, tylko renderowanie
• Adapter graficzny WDDM3.1
• Karta graficzna WDDM3.2
• Adapter graficzny wyłącznie do wyświetlania WDDM3.2
• Adapter graficzny WDDM3.2, tylko renderowanie
• Adapter graficzny WDDM3.2 maszyny wirtualnej
• Tablet graficzny
• Czujnik żyroskopu
• Dysk twardy
• Przekształcenia wielofunkcyjne sprzętu
• Klawiatura
• Klawiaturowy przełącznik myszy
• Sieć lokalna
• LAN (serwer)
• LAN CS
• Maszyna wirtualna sieci LAN (serwer)
• Laptop
• Laptop z funkcją Touch
• Wyświetlacz lcd
• Czujnik światła
• Czujnik lokalizacji
• Media Player
• Mobilny szerokopasmowy dostęp CDMA
• Mobilny Internet Szerokopasmowy GSM
• Telefon komórkowy
• Ekran
• Płyta główna
• Fuzja czujników ruchu
• Drukarka wielofunkcyjna
• Zbliżenie pola
• Urządzenie multimediów sieciowych
• Funkcja NFC
• Czytnik kart inteligentnych NFC
• Napęd optyczny
• Pen Digitizer
• Rysunek wskazujący
• PrecisionTouchpad
• Czujnik obecności
• Drukarka
• Projektor
• Magazyn wymienny
• Router
• Skaner
• Kontroler SDIO
• Serwer
• Program weryfikacji wirtualizacji serwera
• Tablet do podpisu
• Karty inteligentne
• Czytnik kart inteligentnych
• Macierz magazynowa
• Kontroler magazynu
• Adapter przestrzeni dyskowych
• Przestrzenie dyskowe
• Tablet
• Dotyk
• Monitor dotykowy
• TPM20
• Ultra-Mobile Komputer osobisty
• Ultra-Mobile PC z ekranem dotykowym
• Kontroler USB
• Koncentrator USB
• WebCam
• Sieć WLAN
• WLAN CSB
• Drukarka wielofunkcyjna WSD
• Drukarka WSD
• Skaner WSD

Lista kodów rodziny systemów operacyjnych

W poniższej tabeli wymieniono kody rodziny systemów operacyjnych i ich opisy.

Lista kodów systemu operacyjnego

W poniższej tabeli wymieniono kody systemu operacyjnego i ich opisy.

Kody błędów

Kody błędów mają zastosowanie do wszystkich metod webowych API. Jeśli nie można pomyślnie ukończyć żądania, odpowiedź zawiera jeden z następujących kodów błędów HTTP.

Jeśli występują błędy poprawności funkcjonalnej, treść odpowiedzi zawiera jeden z następujących kodów błędów funkcjonalnych.

Zobacz też

• Przykładowe interfejsy API pulpitu nawigacyjnego sprzętu (GitHub)