Condividi tramite

Gestire le etichette di spedizione

  • Articolo

Usare i metodi seguenti per gestire le etichette di spedizione per gli invii di dashboard hardware Windows. Per un'introduzione alle API del dashboard hardware Microsoft, inclusi i prerequisiti per l'uso dell'API, vedere API del dashboard hardware.

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

Metodi per la gestione delle etichette di spedizione

Descrizione Method URI
Creare una nuova etichetta di spedizione POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels
Aggiornare un'etichetta di spedizione PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId}
Annullare un'etichetta di spedizione PUT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId/cancel}

Creare una nuova etichetta di spedizione

  1. Se non è già stato fatto, completare tutti i prerequisiti per le API hardware Microsoft.

  2. Ottenere un token di accesso microsoft Entra ID. Devi passare questo token di accesso ai metodi nell'API di invio di Microsoft Store. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.

  3. Devi aver creato un prodotto e un invio per creare un'etichetta di spedizione. Vedi Gestire gli invii di prodotti per informazioni dettagliate sulla creazione di un prodotto e un invio.

  4. Creare una nuova etichetta di spedizione per questo invio eseguendo il metodo seguente. Usare ProductID e SubmissionID creati in Gestire gli invii di prodotti durante il passaggio precedente.

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

    Il corpo della risposta contiene una risorsa etichetta di spedizione che include l'ID per l'etichetta di spedizione appena creata e altri dettagli.

Esempi di codice

L'esempio di codice seguente illustra come usare l'API Hardware Microsoft:

Risorse dati

I metodi delle API hardware Microsoft per la creazione e la gestione dei dati dei prodotti usano la risorsa dati JSON seguente:

Codici di errore

Per informazioni sui codici di errore, vedi Codici di errore.

Vedi anche