Risolvi gli errori più comuni delle API REST
Quando lavori con l'API di Wrike, gli errori sono inevitabili. Possono verificarsi per vari motivi, ad esempio diritti utente insufficienti, limitazioni di licenza dell'account o formattazione errata. In questo articolo esamineremo alcuni degli errori API più comuni e forniremo passaggi di risoluzione dei problemi per aiutarti a identificarli e correggerli rapidamente.
Importante
Verifica sempre due volte la documentazione dell'API.
Di seguito è riportato un esempio tipico di risposta di errore a seguito di una richiesta API non riuscita.
Codice di stato: XXX
Corpo della risposta:
{
"errorDescription": "human-readable description of the error.",
"error": "short, standardized code or identifier for the specific error that occurred"
}
Codici di stato
Possibile causa
URL di base non corretto.
Passaggi per la risoluzione
Verifica che il tuo URL di base sia corretto.
Wrike archivia i dati dei clienti in più data center situati negli Stati Uniti e nell'Unione Europea. Per accedere ai tuoi dati, utilizza l'URL di base appropriato in base alla loro posizione. Puoi determinare il tuo URL di base osservando l'indirizzo nella barra degli indirizzi quando accedi al tuo account Wrike tramite browser.
Possibile causa
- Il tipo di richiesta HTTP non è valido, i dati critici della richiesta sono assenti o errati (ad es., corpo dell'allegato mancante).
- Manca l'intestazione.
- Il nome del parametro della richiesta non è valido.
- Il parametro della richiesta non è supportato per questo endpoint.
Esempio: Un utente tenta di usare il parametro 'firstName' in una chiamata GET/contacts
Passaggi per la risoluzione
- Controlla la documentazione dell'API per assicurarti che la tua richiesta sia formattata correttamente: tutti i parametri devono essere validi e supportati dall'endpoint.
- Assicurati che tutte le intestazioni necessarie siano incluse nella richiesta.
Possibile causa
- Il parametro obbligatorio è assente.
- Il valore del parametro è compilato o formattato in modo errato.
Passaggi per la risoluzione
- Ricontrolla la documentazione e assicurati che tutti i parametri contrassegnati come obbligatori siano presenti nella tua chiamata.
- Assicurati che il valore del parametro sia corretto e formattato secondo la documentazione.
Possibile causa
È stato utilizzato un metodo API non corretto.
Esempio: Un utente cerca di inviare una chiamata PUT/tasks che non è supportata.
Passaggi per la risoluzione
Assicurati che il metodo che utilizzi sia supportato dall'endpoint e impostato correttamente.
Possibile causa
L'azione richiesta non è consentita a causa di limitazioni di licenza/quota, ecc.
- L'utente non dispone delle autorizzazioni necessarie per eseguire l'azione richiesta.
Esempio: Un utente con un abbonamento Business Plus effettua la chiamata GET/data_export method.
-
L'account non dispone della licenza necessaria per eseguire l'operazione.
Esempio: Un Collaboratore tenta di aggiornare il titolo di una cartella. -
L'operazione non può essere eseguita.
Esempio: Un utente ha cercato di creare una dipendenza già esistente.
Passaggi per la risoluzione
- Rivedi le autorizzazioni dell'utente nelle impostazioni dell'account Wrike. Assicurati che l'utente disponga delle autorizzazioni necessarie per accedere alla risorsa richiesta.
- Verifica la licenza dell'account. Potrebbe essere necessario eseguire l'upgrade della licenza per utilizzare questo metodo API.
- Verifica se l'utente può eseguire la stessa operazione nell'interfaccia utente.
Possibile causa
Il ritmo di richieste dallo stesso indirizzo IP (5000/min) o per utente (400/min) ha superato il limite. Le prime 400 richieste al minuto vengono elaborate, tutte quelle oltre tale soglia restituiscono lo stato 429.
Passaggi per la risoluzione
- Se ricevi risposte HTTP 429 alla tua richiesta, valuta di utilizzare tentativi di nuovo invio con backoff esponenziale.
- Distribuisci il carico tra più utenti.
- Se il problema persiste, contatta il nostro Team di assistenza.
Possibile causa
È stato superato il limite di richieste
Passaggi per la risoluzione
Possibile causa
- Il server ha riscontrato una condizione imprevista che gli ha impedito di soddisfare la richiesta.
- L'utente non ha accesso alla risorsa richiesta
Passaggi per la risoluzione dei problemi
- Controlla la pagina di stato di Wrike per verificare se ci sono problemi diffusi.
- Se non ci sono interruzioni, contatta il nostro Team di assistenza per ulteriori indagini.
Possibile causa
Stai cercando di recuperare una risorsa che non esiste.
Esempio: Un utente invia una chiamata per recuperare le attività da una cartella vuota con la chiamata GET/folders/{folderId}/tasks
Passaggi per la risoluzione dei problemi
Assicurati che la risorsa (ad es. attività/cartella/progetto, ecc.) esistano nell'account.
Suggerimenti pro
Identificare l'account a cui appartiene il tuo token
Hai più account Wrike e non sei sicuro a quale sia attribuito il tuo token? Non preoccuparti, è facile individuarlo. Ti basta eseguire la chiamata GET/account per confermare.
Tracciare il proprietario del tuo token
Se hai testato l'API con più utenti e desideri identificare il proprietario di un determinato token, esiste un modo semplice e diretto. Recupera i dettagli del profilo dell'utente inviando la chiamata GET/contacts?me=true.
Se le difficoltà persistono, contatta il nostro Team di assistenza e saremo lieti di aiutarti.
Per velocizzare la risoluzione, fornisci i seguenti dettagli:
- Il tuo obiettivo con la chiamata API.
- L'intera richiesta API che hai inviato.
- La risposta che hai ricevuto.
-
[In caso di problemi relativi a permessi o token]
La parte centrale del token, così possiamo decodificarlo dal nostro lato.
Di seguito un esempio di access token. Avremo bisogno che ci invii la parte racchiusa tra i 2 punti (in grassetto) e ometta le parti prima e dopo il punto:eyJ0dCI6InAiLCJhbGciOiJIUzI1NiIsInR2IjoiMSJ9.eyJkIjoie1wiYVwiOjM5MjA2MDIsXCJpXCI6NzIyMzMxOCxcImNcIjo0NjIwNzcwLFwidVwiOjY5NzA4NjcsXCJyXCI6XCJVU1wiLFwic1wiOltcIldcIixcIkZcIixcIklcIixcIlVcIixcIktcIixcIkNcIixcIkRcIixcIk1cIixcIkFcIixcIkxcIixcIlBcIl0sXCJ6XCI6W10sXCJ0XCI6MH0iLCJpYXQiOjE1OTk5MDk0MzV9.q3qOJs2swWSCgZl1ueKYsUyhME4RBD4cl53vZ0pwDccImportante
Non inviare mai l'intero token! Condividere il tuo token permanente equivale a condividere la password del tuo account Wrike.