Codes d'erreur
Les codes d'erreur comportent deux niveaux. Le code externe reflète le résultat de la couche API, et data.bizCode reflète le résultat métier. Un appel n'aboutit que si code == 0 et data.bizCode == 0. Voir Structure de réponse unifiée.
Codes d'erreur de l'API (code)
| code | Description | Suggestion |
|---|---|---|
| 0 | Succès | — |
| 401 | Échec de l'authentification | Recherchez la cause précise dans le tableau ci-dessous |
| 429 | Too Many Requests | Réduisez la fréquence des appels et réessayez ; chaque API accepte jusqu'à 10 requêtes / seconde |
Causes de l'erreur 401
| Message | Signification | Suggestion |
|---|---|---|
| Missing required headers | Un en-tête de requête obligatoire est manquant | Vérifiez que tous les En-têtes de requête communs sont présents |
| Invalid timestamp format | Le format de l'horodatage est incorrect | X-Timestamp doit être un horodatage en secondes |
| Request timestamp expired | L'horodatage de la requête a expiré | Synchronisez l'horloge du serveur et renvoyez la requête |
| Invalid nonce format | Le nonce ne respecte pas la règle de format | Doit correspondre à ^[A-Za-z0-9]{16,32}$ |
| Nonce already used or validation failed | Le nonce a déjà été utilisé ou sa validation a échoué | Utilisez une nouvelle chaîne aléatoire pour chaque requête ; ne la réutilisez jamais |
| appId not found | L'appId n'existe pas | Vérifiez APP-ID |
| appId is disabled | L'appId a été désactivé | Contactez le support technique |
| Signature calculation failed | Le calcul de la signature a échoué | Vérifiez votre implémentation de la signature ; voir Mécanisme de signature |
| Signature verification failed | La vérification de la signature a échoué | Vérifiez l'ordre de concaténation de la chaîne à signer, que path inclut le préfixe /open-apis, et que timestamp et nonce correspondent aux en-têtes |
Codes d'erreur métier (bizCode)
| bizCode | Description |
|---|---|
| 0 | Succès |
| 10000001 | Paramètres non valides |
| 10000003 | Trop de requêtes. Patientez, puis réessayez |
| 10000103 | Le service système rencontre une anomalie ; contactez le service client |
| 100027001 | Paramètres d'opération sur les crédits non valides |
| 100027003 | Solde de crédits insuffisant |
| 100041003 | La tâche de modélisation spatiale n'existe pas |
| 100041004 | Résultat de modélisation spatiale introuvable |
| 100041006 | Espace introuvable |
| 100041010 | L'AppId ne dispose pas de l'autorisation de modélisation spatiale |
| 100041016 | Tâche à l'état [modélisation en cours], suppression non autorisée |
| 100041017 | La tâche ne peut pas être annulée dans son état actuel |
Dépannage des échecs de modélisation
Lorsqu'une tâche passe à l'état Échec de la modélisation (9), appelez Liste paginée des tâches ou Détails de la tâche et lisez errorCode et failedReason pour en trouver la cause.
Ces deux champs transmettent les informations d'échec issues du pipeline de modélisation et utilisent un ensemble de valeurs différent de celui de bizCode ci-dessus. Lorsqu'un appel d'API réussit mais que la modélisation de la tâche échoue, bizCode vaut toujours 0.