Compartilhar via


Obter todos os produtos

Use esse método na API de Hardware da Microsoft para recuperar dados de todos os produtos registrados em sua conta do Centro de Desenvolvimento do Windows.

Pré-requisitos

Se você ainda não fez isso, conclua todos os pré-requisitos para as APIs de Hardware da Microsoft antes de tentar usar qualquer um desses métodos.

Solicitação

Esse método tem a seguinte sintaxe. Veja as seções a seguir para obter exemplos de uso e descrições do corpo da solicitação e do cabeçalho.

Método URI da solicitação
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/

Cabeçalho da solicitação

parâmetro Tipo Descrição
Autorização string Obrigatórios. O token de acesso de ID de Microsoft Entra no token> de portador<do formulário.
accept string Opcional. Especifica o tipo de conteúdo. O valor permitido é "application/json"

Parâmetros da solicitação

Não forneça parâmetros de solicitação para esse método.

Corpo da solicitação

Não forneça um corpo da solicitação para esse método.

Exemplos de solicitação

O exemplo a seguir demonstra como recuperar informações sobre todos os produtos registrados em sua conta.

GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/ HTTP/1.1
Authorization: Bearer <your access token>

Resposta

O exemplo a seguir demonstra o corpo da resposta JSON retornado por uma solicitação bem-sucedida para todos os produtos registrados em uma conta de desenvolvedor. Para resumir, este exemplo mostra apenas os dados dos dois primeiros produtos retornados pela solicitação. Para obter mais detalhes sobre os valores no corpo da resposta, veja a seção a seguir.

{
  "value": [
    {
            "id": 9007199267351834,
            "sharedProductId": 1152921504606971255,
            "links": [
                {
                    "href": "https://hardwareapi.microsoft.com/api/v1/hardware/products/9007199267351834",
                    "rel": "self",
                    "method": "GET"
                },
                {
                    "href": "https://hardwareapi.microsoft.com/api/v1/hardware/products/9007199267351834/submissions",
                    "rel": "get_submissions",
                    "method": "GET"
                }
            ],
            "isCommitted": true,
            "isExtensionInf": false,
            "originType": "author",
            "sourceProductId": 0,
            "sourcePublisherId": 0,
            "isRetpolineCompiled": false,
            "message": "",
            "deviceMetadataIds": [],
            "deviceType": "notSet",
            "isTestSign": false,
            "isFlightSign": false,
            "marketingNames": [],
            "productName": "NewDriverHacked",
            "selectedProductTypes": {},
            "requestedSignatures": [
                "WINDOWS_v100_X64_TH1_FULL",
                "WINDOWS_v63_X64"
            ],
            "additionalAttributes": {},
            "testHarness": "hlk"
        },
        {
            "id": 9007199267351835,
            "sharedProductId": 1152921504606971256,
            "links": [
                {
                    "href": "https://hardwareapi.microsoft.com/api/v1/hardware/products/9007199267351835",
                    "rel": "self",
                    "method": "GET"
                },
                {
                    "href": "https://hardwareapi.microsoft.com/api/v1/hardware/products/9007199267351835/submissions",
                    "rel": "get_submissions",
                    "method": "GET"
                }
            ],
            "isCommitted": true,
            "isExtensionInf": false,
            "originType": "author",
            "sourceProductId": 0,
            "sourcePublisherId": 0,
            "isRetpolineCompiled": false,
            "message": "",
            "announcementDate": "2016-10-22T00:00:00Z",
            "deviceMetadataCategory": "Input.Digitizer.Multitouch",
            "deviceMetadataIds": [],
            "deviceType": "internalExternal",
            "isTestSign": false,
            "isFlightSign": false,
            "marketingNames": [
                "MEU"
            ],
            "productName": "Mew2?",
            "selectedProductTypes": {
                "Windows_v100": "Touch",
                "Windows81": "Unclassified"
            },
            "requestedSignatures": [
                "WINDOWS_v100_X64_TH1_FULL",
                "WINDOWS_v63_X64"
            ],
            "additionalAttributes": {},
            "testHarness": "hlk"
        }
  ]
}

Corpo da resposta

Valor Tipo Descrição
value array Uma matriz de objetos que contêm informações sobre cada produto registrado em sua conta. Para obter mais informações sobre os dados em cada objeto, consulte Recurso de produto.
links array Uma matriz de objetos com links úteis sobre a entidade que contém. Consulte o objeto link para obter mais detalhes

Códigos do Erro

Para obter mais informações, consulte Códigos de erro. 

Confira também