Codici di errore
I codici di errore sono su due livelli. Il code esterno riflette l'esito a livello di API, mentre data.bizCode riflette l'esito di business. Una chiamata ha esito positivo solo quando code == 0 e data.bizCode == 0. Vedi Struttura di risposta unificata.
Codici di errore dell'API (code)
| code | Descrizione | Suggerimento |
|---|---|---|
| 0 | Successo | — |
| 401 | Autenticazione non riuscita | Individua la causa specifica nella tabella seguente |
| 429 | Too Many Requests | Riduci la frequenza delle chiamate e riprova; ogni API consente fino a 10 richieste / secondo |
Cause del 401
| Messaggio | Significato | Suggerimento |
|---|---|---|
| Missing required headers | Manca un'intestazione di richiesta obbligatoria | Verifica che siano presenti tutte le Intestazioni di richiesta comuni |
| Invalid timestamp format | Il formato del timestamp non è corretto | X-Timestamp deve essere un timestamp in secondi |
| Request timestamp expired | Il timestamp della richiesta è scaduto | Sincronizza l'orologio del server e invia di nuovo la richiesta |
| Invalid nonce format | Il nonce non rispetta la regola di formato | Deve corrispondere a ^[A-Za-z0-9]{16,32}$ |
| Nonce already used or validation failed | Il nonce è già stato usato o non ha superato la verifica | Usa una nuova stringa casuale per ogni richiesta; non riutilizzarla mai |
| appId not found | L'appId non esiste | Controlla APP-ID |
| appId is disabled | L'appId è stato disattivato | Contatta il supporto tecnico |
| Signature calculation failed | Il calcolo della firma non è riuscito | Controlla l'implementazione della firma; vedi Meccanismo di firma |
| Signature verification failed | La verifica della firma non è riuscita | Controlla l'ordine di concatenazione della stringa da firmare, che path includa il prefisso /open-apis e che timestamp e nonce corrispondano alle intestazioni |
Codici di errore di business (bizCode)
| bizCode | Descrizione |
|---|---|
| 0 | Successo |
| 10000001 | Parametri non validi |
| 10000003 | Troppe richieste. Attendi e riprova |
| 10000103 | Il servizio di sistema presenta un'anomalia, contatta l'assistenza clienti |
| 100027001 | Parametri dell'operazione sui crediti non validi |
| 100027003 | Saldo crediti insufficiente |
| 100041003 | L'attività di modellazione spaziale non esiste |
| 100041004 | Risultato della modellazione spaziale non trovato |
| 100041006 | Spazio non trovato |
| 100041010 | L'AppId non dispone dell'autorizzazione per la modellazione spaziale |
| 100041016 | Stato dell'attività [modellazione in corso], l'eliminazione non è consentita |
| 100041017 | L'attività non può essere annullata nello stato attuale |
Risoluzione dei problemi di modellazione non riuscita
Quando un'attività passa allo stato Modellazione non riuscita (9), chiama Elenco attività paginato o Dettagli attività e leggi errorCode e failedReason per individuare la causa.
Questi due campi riportano le informazioni di errore provenienti dalla pipeline di modellazione e usano un insieme di valori diverso dal bizCode descritto sopra. Quando una chiamata API riesce ma l'attività non viene modellata, bizCode resta 0.