Ottenere un'etichetta di spedizione
Usare questo metodo per recuperare i dati per un'etichetta di spedizione specifica di un invio specifico di un prodotto.
Prerequisiti
Se non è già stato fatto, completare tutti i prerequisiti per le API hardware Microsoft prima di provare a usare uno di questi metodi. Prima di poter usare questi metodi, il prodotto e l'invio devono già esistere nell'account dev Center. Per creare o gestire gli invii per i prodotti, vedere i metodi in Gestire gli invii di prodotti.
Richiesta
La sintassi di questo metodo è la seguente. Vedi le sezioni seguenti per esempi di uso e descrizioni dell'intestazione e del contenuto della richiesta.
| Metodo | URI richiesta |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/{shippingLabelId} |
Intestazione della richiesta
| Intestazione | Tipo | Descrizione |
|---|---|---|
| authorization | string | Obbligatorio. Token di accesso id Microsoft Entra nel modulo Bearer *<token>*. |
| Accettare | string | Facoltativa. Specifica il tipo di contenuto. Il valore consentito è "application/json" |
Parametri della richiesta
I parametri della richiesta sono facoltativi per questo metodo.
| Nome | Tipo | Descrizione |
|---|---|---|
| includeTargetingInfo | boolean | facoltativo. Se questo parametro è impostato su true, l'etichetta di spedizione restituisce i dettagli di destinazione dell'etichetta di spedizione, ad esempio ID hardware e CHID. Per altre informazioni, vedere Destinazione dell'oggetto . |
Testo della richiesta
Non includere il contenuto della richiesta per questo metodo.
Esempi di richiesta
Nell'esempio seguente viene illustrato come recuperare informazioni su un prodotto specifico registrato nell'account.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964156/submissions/1152921504621467600/shippingLabels/1152921504606980300 HTTP/1.1
Authorization: Bearer <your access token>
Risposta
Nell'esempio seguente viene illustrato il corpo della risposta JSON restituito da una richiesta di esito positivo per un'etichetta di spedizione specifica. I dettagli sui valori nel corpo della risposta vengono visualizzati nella tabella seguente l'esempio.
{
"id": 1152921504606978300,
"productId": 14461751976964156,
"submissionId": 1152921504621467600,
"publishingSpecifications": {
"goLiveDate": "2018-04-12T05:28:32.721Z",
"visibleToAccounts": [
27691110,
27691111
],
"isAutoInstallDuringOSUpgrade": true,
"isAutoInstallOnApplicableSystems": true,
"isDisclosureRestricted": false,
"publishToWindows10s": false,
"additionalInfoForMsApproval": {
"microsoftContact": "abc@mcirosoft.com",
"validationsPerformed": "Validation 1",
"affectedOems": [
"OEM1",
"OEM2"
],
"isRebootRequired": false,
"isCoEngineered": true,
"isForUnreleasedHardware": true,
"hasUiSoftware": false,
"businessJustification": "This is a business justification"
}
},
"targeting": {
"hardwareIds": [
{
"bundleId": "amd64",
"infId": "foo.inf",
"operatingSystemCode": "WINDOWS_v100_SERVER_X64_RS5_FULL",
"pnpString": "hid\\vid_dummy256f&pid_dummyc62f",
"distributionState": "pendingAdd"
},
{
"bundleId": "amd64",
"infId": "foo.inf",
"operatingSystemCode": "WINDOWS_v100_RS2_FULL",
"pnpString": "hid\\vid_dummy256f&pid_dummyc62f",
"distributionState": "pendingAdd"
}
],
"chids": [
{
"chid": "346511cf-ccee-5c6d-8ee9-3c70fc7aae83",
"distributionState": "pendingAdd"
}
],
"restrictedToAudiences": [
"00000000-0000-0000-0000-000000000000",
"00000000-0000-0000-0000-000000000001"
],
"inServicePublishInfo": {
"flooring": "RS1",
"ceiling": "RS3"
},
"coEngDriverPublishInfo": {
"flooringBuildNumber": 17135,
"ceilingBuildNumber": 17139
}
},
"workflowStatus": {
"currentStep": "microsoftApproval",
"state": "started",
"messages": []
},
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978459",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978459",
"rel": "update_shippinglabel",
"method": "PATCH"
}
],
"name": "VR_RS4Build_DualPublishCheck",
"destination": "windowsUpdate"
}
Corpo della risposta
Per informazioni dettagliate sul corpo della risposta, vedere La risorsa ShippingLabel.
Codici di errore
Per informazioni sui codici di errore, vedere Codici di errore.