Administración de etiquetas de envío
Use los métodos siguientes para administrar las etiquetas de envío para los envíos del panel de hardware de Windows. Para obtener una introducción a las API del panel de hardware de Microsoft, incluidos los requisitos previos para usar la API, consulte API de panel de hardware.
https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels
Métodos para administrar etiquetas de envío
Descripción | Método | URI |
---|---|---|
Creación de una nueva etiqueta de envío | PUBLICAR | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels |
Actualización de una etiqueta de envío | PATCH | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId} |
Cancelación de una etiqueta de envío | PUT | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId/cancel} |
Creación de una nueva etiqueta de envío
Si aún no lo ha hecho, complete todos los requisitos previos de la API de hardware de Microsoft.
Obtenga un token de acceso de Microsoft Entra ID. Debe pasar este token de acceso a los métodos de la API de envío de Microsoft Store. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
Debe haber creado un producto y un envío para crear una etiqueta de envío. Consulte Administración de envíos de productos para obtener más información sobre cómo crear un producto y un envío.
Cree una nueva etiqueta de envío para este envío ejecutando el método siguiente. Use ProductID y SubmissionID creados en Administración de envíos de productos durante el paso anterior.
https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels
El cuerpo de la respuesta contiene un recurso de etiqueta de envío que incluye el identificador de la etiqueta de envío recién creada y otros detalles.
Ejemplos de código
En el ejemplo de código siguiente se muestra cómo usar la API de hardware de Microsoft:
Recursos de datos
Los métodos de las API de hardware de Microsoft para crear y administrar datos del producto usan el siguiente recurso de datos JSON:
Códigos de error
Para obtener información sobre los códigos de error, consulte Códigos de error.