Condividi tramite


Gestire le etichette di spedizione

Usare i metodi seguenti per gestire le etichette di spedizione per gli invii di dashboard hardware Windows. Per un'introduzione alle API di Microsoft per il dashboard hardware, 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 Metodo 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 INSERIRE 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 dell'API di invio del Microsoft Store. Dopo aver ottenuto un token di accesso, si hanno 60 minuti per usarlo 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 l'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, vedere codici di errore .

Vedere anche