Chaque appel d'API ou de SDK vers la plateforme ouverte AI Search renvoie un code d'état HTTP. Les codes compris dans la plage 2xx indiquent une réussite. Les codes de la plage 4xx signalent un problème lié à votre requête. Les codes de la plage 5xx indiquent un problème côté serveur.
Utilisez les champs code et status présents dans la réponse pour identifier l'erreur spécifique.
Référence des codes d'état
| Catégorie | Code d'état HTTP | Code d'erreur | Message d'erreur | Description |
|---|---|---|---|---|
| Erreur de requête | 400 | InvalidParameter | Required parameter(s) missing or invalid, please check the request parameters. | Un ou plusieurs paramètres de la requête ne sont pas valides. |
| 400 | ServiceIdNotExist | service_id is not exist. | L'identifiant du service n'existe pas. | |
| 429 | Throttling | Requests throttling triggered. | L'appel d'API déclenche une limitation de débit. | |
| 429 | Throttling.RateQuota | Requests rate limit exceeded, please try again later. | Le débit de la requête dépasse la limite autorisée (par exemple, le nombre de requêtes par seconde). | |
| 429 | Throttling.AllocationQuota | Allocated quota exceeded, please increase your quota limit. | Le nombre d'appels sur une période donnée dépasse votre quota alloué (par exemple, le nombre de jetons générés par minute). | |
| 429 | Throttling.AllocationQuota | Free allocated quota exceeded. | Votre quota gratuit est épuisé. Activez l'accès facturable pour poursuivre. | |
| Erreur serveur | 500 | InternalServerError | An internal error has occured, please try again later or contact service support. | Une erreur interne s'est produite. |
Réponse d'erreur
En cas d'échec d'une requête, la réponse inclut un code d'état HTTP ainsi qu'un corps JSON contenant les détails de l'erreur. Exemple :
{
"request_id": "817964CD-1B84-4AE1-9B63-4FB99734DD41",
"latency": 0,
"code": "InvalidParameter",
"message": "JSON parse error: Invalid UTF-8 start byte 0xbc; nested exception is com.fasterxml.jackson.core.JsonParseException: Invalid UTF-8 start byte 0xbc\n at line: 2, column: 19]"
}Paramètres de la réponse
| Paramètre | Type | Description |
|---|---|---|
| Code d'état HTTP | entier | Le code 200 indique une réussite. Tout autre code signale un échec. En cas d'échec, les paramètres code et message contiennent les détails de l'erreur. |
| request_id | chaîne | Identifiant unique de cette requête. Utilisez cette valeur pour localiser la requête lors du dépannage. |
| code | chaîne | Code d'erreur. Reportez-vous à la colonne Error code du tableau de référence des codes d'état. |
| message | chaîne | Message d'erreur. Consultez la colonne Error message du tableau de référence des codes d'état. Le message réel peut contenir des détails plus précis que ceux affichés dans le tableau. |