Linee guida per contattare l’assistenza dei fornitori di soluzioni

Dicci cosa stai cercando di fare, cosa è successo invece e i passaggi che l’hanno portato a farlo.

Per un errore SP-API, includi questi dettagli per una chiamata interessata:

• L’endpoint completo, inclusi l’host e il percorso, e il metodo HTTP
• Il nome, la versione e il funzionamento dell’API
• L’ID della richiesta e il timestamp UTC della chiamata
• Il codice di stato HTTP e la risposta di errore completa
• L’ID dell’applicazione, l’ID del marketplace e la regione SP-API
• Il token venditore del venditore che stai chiamando
• Se la chiamata era una richiesta sandbox
• L’ID del feed o l’ID del report per i problemi relativi all’API Feeds o all’API Reports oppure l’ID di invio per i problemi relativi all’API Listings Items
• Intestazioni e corpi di richiesta e risposta, con ogni valore di credenziale sostituito da

Ti consigliamo di riprodurre la chiamata in Postman, che mostra se il problema persiste all’esterno dell’applicazione. Per raccogliere i dettagli, apri la Postman Console, seleziona la richiesta ed espandi la richiesta e la risposta.

Copia i dettagli in un file.txt e sostituisci ogni valore di credenziale con <Redacted>prima di allegarlo. Per la configurazione, vai a Using Postman for Selling Partner API Models.

Se l’errore si verifica su un sito Web o su una pagina del portale, ad esempio Solution Provider Portal, allega un file HAR (HTTP Archive) sanificato che registri l’errore. Un file HAR registra l’attività di rete del browser durante il caricamento della pagina.
Per registrarne uno in Google Chrome:

1. Apri una finestra di navigazione in incognito e vai alla pagina in cui si verifica l’errore. Non ripetere ancora l’azione fallita.
2. Apri Developer Tools (F12 su Windows, Cmd+Option+I su Mac) e seleziona la scheda Rete.
3. Seleziona Conserva registro, quindi fai clic su Cancella per avviare una registrazione pulita.
4. Ripeti i passaggi che causano l’errore.
5. Fai clic con il pulsante destro del mouse sulle righe registrate e seleziona Copia tutto come HAR (disinfettato). Incolla il risultato in un file di testo semplice e salvalo con un estensione.har.

L’opzione igienizzata rimuove i cookie e i token di accesso. Non rimuove nulla di ciò che digiti nella pagina. Non inserire una password reale, informazioni di pagamento o un ID personale durante la registrazione, a meno che non sia necessario per riprodurre l’errore. Per i passaggi dettagliati, consulta Come posso creare file HAR e log di console dal mio browser per un caso di AWS Support?

Non includere token di aggiornamento, token di accesso, token di dati limitati, segreti dei clienti, credenziali AWS, intestazioni di autorizzazione, cookie o URL firmati in un case, un allegato o uno screenshot. Per ulteriori informazioni, consulta Salvaguardare le credenziali sensibili.

Dicci quali soluzioni hai provato e perché non hanno funzionato. In questo modo non suggeriamo qualcosa che hai già escluso e, a volte, una piccola modifica a uno dei tuoi passaggi risolve il problema.

• Meno utile: abbiamo provato diverse cose, ma niente funziona.
• Ancora utile: abbiamo seguito i passaggi indicati in [URL della pagina] e l’ultimo passaggio ha restituito l’errore XXXX.

Dicci cosa vuoi ottenere e includi il messaggio di errore completo. Una domanda di una riga di solito porta a domande successive, il che rallenta la risoluzione.

• Meno utile: non riesco a ricevere ordini. Cosa devo fare?
• Ancora utile: quando chiamo getOrders nell’API Orders di Postman, ricevo «Errore: parametri non validi». Il timestamp è YYYY-MM-DD HH:MM UTC e l’ID della richiesta è XXXXXXXX. Voglio recuperare tutti gli ordini creati nelle ultime 24 ore.

Esaminiamo ogni possibile causa, tra cui il metodo di chiamata, le autorizzazioni mancanti e i problemi temporanei di assistenza. Potremmo anche suggerirti un modo diverso per raggiungere il tuo obiettivo.

Allega registri degli errori e schermate quando apri la custodia. Questo è il modo più rapido per abbreviare i tempi di risoluzione. Se hai cambiato il formato del registro, facci sapere cosa è cambiato. Prima di allegare un registro o uno screenshot, verifica che non mostri alcuna credenziale.

• Tipo di API: seleziona il tipo di API a cui si riferisce la tua domanda.
• Tipo di problema: seleziona la categoria adatta alla tua domanda.
• Sezione API: se selezioni Errore API come tipo di problema, seleziona l’API a cui si riferisce la tua domanda.
• Descrivi il problema: segui le indicazioni in Descrivi il problema.
• ID venditore o sviluppatore correlato: inserisci l’ID venditore o sviluppatore che presenta il problema.
• Marketplace interessati: inserisci il negozio in cui si è verificato il problema.
• Operazioni API correlate: inserisci l’operazione che stai chiamando, ad esempio getOrders.
• ID applicazione SP-API/MWS: inserite l’ID dell’applicazione.

Un membro del team gestisce un caso alla volta, quindi alle domande non correlate viene data risposta più rapidamente in casi separati. Ad esempio, apri un caso sul recupero dei dati e un caso separato sui limiti di velocità. Conserva le domande strettamente correlate in un unico caso. Un membro del nostro team potrebbe suggerire di suddividere un caso.

Se chiedi informazioni su una risorsa che è stata eliminata, potremmo non essere in grado di indagare a fondo sulla causa.

I fallimenti sono imprevedibili e inevitabili. Sebbene il nostro team di assistenza tecnica si impegni ad analizzare le cause e a ridurre l’incidenza dei guasti dell’infrastruttura, è difficile prevenire completamente il verificarsi di tali guasti.

Per questo motivo, consigliamo «Design For Failure» (progettazione per il fallimento).

Non forniamo spiegazioni dettagliate dei guasti. Questo perché riteniamo che fornire informazioni dettagliate sulla causa di un guasto non influisca sulla soluzione alternativa del cliente e non sia essenziale per risolvere il problema del cliente. Piuttosto, miriamo a risolvere rapidamente i vostri problemi mostrandovi come utilizzare correttamente i nostri servizi di monitoraggio e dare priorità al ripristino primario.

Le prestazioni dipendono dall’ambiente e dal carico di lavoro, quindi non possiamo fornire benchmark generali. Ti consigliamo di misurare le prestazioni nel tuo ambiente.

Condividi le richieste di nuove funzionalità o miglioramenti nel tuo caso di supporto e le inoltreremo al team di sviluppo. Non possiamo promettere di creare una richiesta o di avvisarti quando sarà completata, ma il tuo feedback ci aiuta a migliorare.

Se la nostra risposta ha risolto il problema o l’hai risolto tu stesso, annota la risoluzione del caso e chiudilo. La condivisione di ciò che ha funzionato, inclusa qualsiasi correzione che non abbiamo suggerito, ci aiuta a risolvere problemi simili per altri sviluppatori.