Partager via

Gérer les étiquettes d’expédition

  • Article

Utilisez les méthodes suivantes pour gérer les étiquettes d’expédition pour vos soumissions de tableaux de bord matériels Windows. Pour une introduction aux APIS de tableaux de bord matériels Microsoft, y compris les conditions préalables à l’utilisation de l’API, veuillez consulter API de tableau de bord matériel.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels

Méthodes de gestion des étiquettes d’expédition

Description Method URI
Créer une étiquette d’expédition POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels
Mettre à jour une étiquette d’expédition PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId}
Annuler une étiquette d’expédition PUT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId/cancel}

Créer une étiquette d’expédition

  1. Si vous ne l’avez pas encore fait, complétez tous les prérequis pour les API de hardware Microsoft.

  2. Obtenez un token d’accès Microsoft Entra ID. Vous devez transmettre ce jeton d’accès aux méthodes dans l’API de soumission au Microsoft Store. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.

  3. Pour créer une étiquette d’expédition, il faut avoir créé un produit et une soumission. Pour en savoir plus sur la création d’un produit et d’une soumission, consultez Gérer les soumissions de produits.

  4. Créez une étiquette d’expédition pour cette soumission en exécutant la méthode suivante. Utilisez les productID et SubmissionID créés dans Gérer les soumissions de produits à l’étape précédente.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels

    Le corps de la réponse contient une ressource d’étiquette d’expédition qui inclut l’ID de l’étiquette d’expédition nouvellement créée et d’autres détails.

Exemples de code

L’exemple de code suivant montre comment utiliser l’API de hardware Microsoft :

Ressources de données

Les méthodes des API de hardware Microsoft pour la création et la gestion des données de produits utilisent la ressource de données JSON suivante :

Codes d’erreur

Pour en savoir plus sur les codes d’erreur, reportez-vous à la section Codes d’erreur.

Voir aussi