Cada llamada a la API o al SDK de AI Search Open Platform devuelve un código de estado HTTP. Los códigos en el rango 2xx indican que la operación fue exitosa. Los códigos en el rango 4xx señalan un problema con su solicitud. Los códigos en el rango 5xx indican un problema en el servidor.
Use los campos code y status de la respuesta para identificar el error específico.
Referencia de códigos de estado
| Categoría | Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|---|
| Error de solicitud | 400 | InvalidParameter | Required parameter(s) missing or invalid, please check the request parameters. | Uno o más parámetros de la solicitud no son válidos. |
| 400 | ServiceIdNotExist | service_id is not exist. | El ID del servicio no existe. | |
| 429 | Throttling | Requests throttling triggered. | La llamada a la API activó la limitación de solicitudes. | |
| 429 | Throttling.RateQuota | Requests rate limit exceeded, please try again later. | La tasa de solicitudes supera el límite permitido, como el número de solicitudes por segundo. | |
| 429 | Throttling.AllocationQuota | Allocated quota exceeded, please increase your quota limit. | El número de llamadas en un periodo excede su cuota asignada; por ejemplo, la cantidad de tokens generados por minuto. | |
| 429 | Throttling.AllocationQuota | Free allocated quota exceeded. | Su cuota gratuita se agotó. Habilite el acceso de pago para continuar. | |
| Error del servidor | 500 | InternalServerError | An internal error has occured, please try again later or contact service support. | Ocurrió un error interno. |
Respuesta de error
Cuando una solicitud falla, la respuesta incluye un código de estado HTTP y un cuerpo JSON con los detalles del error. Por ejemplo:
{
"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]"
}
Parámetros de respuesta
|
Parámetro |
Tipo |
Descripción |
|
Código de estado HTTP |
integer |
|
|
request_id |
string |
Identificador único de esta solicitud. Use este valor para localizar la solicitud al solucionar problemas. |
|
code |
string |
Código de error. Consulte la columna Error code en la tabla de referencia de códigos de estado. |
|
message |
string |
Mensaje de error. Consulte la columna Error message en la tabla de referencia de códigos de estado. El mensaje real puede contener detalles más específicos que los mostrados en la tabla. |