Obtenir toutes les étiquettes d’expédition
Utilisez cette méthode dans l’API matériel Microsoft pour récupérer les données de toutes les étiquettes d’expédition d’une soumission spécifique d’un produit.
Prérequis
Si vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour les API de matériel Microsoft avant d’essayer d’utiliser l’une de ces méthodes. Avant de pouvoir utiliser ces méthodes, le produit et la soumission doivent déjà exister dans votre compte du Centre de développement. Pour créer ou gérer les soumissions de produits, consultez les méthodes dans Gérer les soumissions de produits.
Requête
Cette méthode présente la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et une description de l’en-tête et du corps de la requête.
| Méthode | URI de demande |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/ |
En-tête de requête
| En-tête | Type | Description |
|---|---|---|
| Autorisation | string | Obligatoire. Jeton d’accès d’ID Microsoft Entra au format Porteur *<jeton>*. |
| accepter | string | facultatif. Spécifie le type de contenu. La valeur autorisée est « application/json » |
Paramètres de la demande
Ne fournissez pas de paramètres de requête pour cette méthode.
Corps de la demande
Ne fournissez pas de corps de requête pour cette méthode.
Exemples de demande
L’exemple suivant montre comment récupérer des informations sur tous les produits inscrits sur votre compte.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/ HTTP/1.1
Authorization: Bearer <your access token>
response
L’exemple suivant illustre le corps de la réponse JSON retourné par une demande réussie pour toutes les étiquettes d’expédition d’une soumission spécifique d’un produit inscrit à votre compte de développeur. Par souci de concision, cet exemple montre uniquement les données des trois premières étiquettes d’expédition retournées par la demande. Les détails des valeurs dans le corps de la réponse s’affichent dans le tableau suivant l’exemple.
{
"value": [
{
"id": 1152921504606980300,
"productId": 14461751976964156,
"submissionId": 1152921504621467600,
"publishingSpecifications": {
"goLiveDate": "2018-04-04T16:11:27.2965057+00:00",
"visibleToAccounts": [],
"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"
}
},
"workflowStatus": {
"currentStep": "microsoftApproval",
"state": "started",
"messages": []
},
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606980231",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606980231",
"rel": "update_shippinglabel",
"method": "PATCH"
}
],
"name": "Publish to Windows Update with promotions",
"destination": "windowsUpdate"
},
{
"id": 1152921504606978500,
"productId": 14461751976964156,
"submissionId": 1152921504621467600,
"recipientSpecifications": {
"receiverPublisherId": "27691110",
"enforceChidTargeting": false
},
"workflowStatus": {
"currentStep": "finalizeSharing",
"state": "completed",
"messages": []
},
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978460",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978460",
"rel": "update_shippinglabel",
"method": "PATCH"
}
],
"name": "Share submission with another Partner",
"destination": "anotherPartner"
},
{
"id": 1152921504606978500,
"productId": 14461751976964156,
"submissionId": 1152921504621467600,
"publishingSpecifications": {
"goLiveDate": "2018-04-03T04:50:52.2293001+00:00",
"visibleToAccounts": [],
"isAutoInstallDuringOSUpgrade": false,
"isAutoInstallOnApplicableSystems": false,
"isDisclosureRestricted": false,
"publishToWindows10s": false
},
"workflowStatus": {
"currentStep": "finalizePublishing",
"state": "completed",
"messages": []
},
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978538",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978538",
"rel": "update_shippinglabel",
"method": "PATCH"
}
],
"name": "Publish to Windows Update without promotions",
"destination": "windowsUpdate"
}
],
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products?pageSize=50",
"rel": "self",
"method": "GET"
}
]
}
Cette ressource a les valeurs suivantes
| Valeur | Type | Description |
|---|---|---|
| value | tableau | Tableau d’objets qui contiennent des informations sur chaque étiquette d’expédition. Pour plus d’informations sur les données de chaque objet, consultez Expédition de la ressource d’étiquette. |
| liens | tableau | Tableau d’objets avec des liens utiles sur l’entité contenante. Pour plus d’informations, consultez Objet Link . |
Codes d’erreur
Pour plus d’informations sur les codes d’erreur, consultez Codes d’erreur.