Управление этикетками доставки

  • Статья

Используйте следующие методы для управления этикетками доставки для отправки панелей мониторинга оборудования Windows. Общие сведения об API панели мониторинга оборудования Майкрософт, включая предварительные требования для использования API, см. в разделе API панели мониторинга оборудования.

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

Методы управления этикетками для доставки

Описание Метод URI
Создание новой этикетки доставки POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels
Обновление этикетки доставки PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId}
Отмена этикетки доставки PUT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId/cancel}

Создание новой этикетки доставки

  1. Если вы еще не сделали этого, выполните все предварительные требования для API оборудования Майкрософт.

  2. Получите маркер доступа Microsoft Entra ID. Этот маркер доступа необходимо передавать методам из API отправки в Microsoft Store. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия маркера можно получить новый маркер.

  3. Вы должны были создать продукт и отправку, чтобы создать транспортную этикетку. Дополнительные сведения о создании продукта и отправке см. в разделе Управление отправками продуктов.

  4. Создайте новую этикетку доставки для этой отправки, выполнив следующий метод. Используйте ProductID и SubmissionID, созданные в разделе Управление отправками продуктов на предыдущем шаге.

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

    Текст ответа содержит ресурс этикетки доставки , который содержит идентификатор созданной этикетки и другие сведения.

Примеры кода

В следующем примере кода показано, как использовать API оборудования Майкрософт:

Ресурсы данных

Методы API оборудования Майкрософт для создания данных о продуктах и управления ими используют следующий ресурс данных JSON:

Коды ошибок

Дополнительные сведения о кодах ошибок см. в разделе Коды ошибок.

См. также раздел