Todos los productos
Search
Centro de documentos

OpenSearch:Códigos de estado

Última actualización: Sep 05, 2026

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

200 indica que la operación fue exitosa. Cualquier otro código señala un error. En caso de fallo, los parámetros code y message contienen los detalles correspondientes.

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.