https://api.nexscope.ai/amazon/alexaSearchEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/amazon/alexaSearch |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
prompts | string[] | obligatorio | Una serie de diálogos indica con una longitud de 255 caracteres, sólo 1 es compatible; sólo 1 pregunta puede ser pasada en cada llamada. Cuando se hace a través de las veces, el agente necesita resumir el contexto de la ronda anterior y pasarlo como un nuevo `prompts[0]`. |
format | string | opcional | Formato de respuesta: `markdown` devuelve un informe legible; `json` devuelve un array de datos estructurado. Ejemplo: markdown |
url | string | opcional | Una página de categoría específica, página de resultados de búsqueda o página de detalle del producto URL que se utiliza para complementar el contexto de la página de Alexa; no pase la página principal de Amazon URL. |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.
Campos de respuesta
Referencia de campos de respuesta (24 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
stdout | string | opcional | Informe de preguntas y respuestas de formato Markdown, devuelto sólo cuando `format=markdown` está utilizado. |
data | array | opcional | Array de resultados estructurados de conversación, devueltos sólo si `format=json`. |
resultsNum | integer | opcional | El número de conversaciones que Alexa realmente respondió; 0 significa que no se produjo ninguna respuesta válida. |
code | string | opcional | Código de estado de negocio, éxito es `"200"`, la misma que la versión numérica de `errcode`. |
errcode | integer | opcional | Código de la situación empresarial, `200` indica éxito. |
costTime | integer | opcional | La interfaz toma tiempo en milisegundos. |
costToken | integer | opcional | El número de Tokens consumidos por esta llamada; facturado sólo si el curso previo es exitoso. |
taskId | string | opcional | El ID de la tarea devuelto por el upstream. |
type | string | opcional | Estilo de representación: `stdoutWorkbenches` (Marcado) o `json`. |
prompt | string | opcional | La palabra que se le envió a Alexa para la ronda actual. |
content | string | opcional | El contenido del texto de la respuesta de Alexa en esta ronda. |
screenshot | string | opcional | Enlace a la captura de pantalla de esta conversación. |
followUpQuestions | string[] | opcional | Alexa recomienda una lista de preguntas de seguimiento. |
products | array | opcional | Lista de grupos de productos recomendados, cada grupo contiene `title` y `items`. |
products[].title | string | opcional | Títulos recomendados para grupos. |
products[].items[].asin | string | opcional | Producto ASIN. |
products[].items[].title | string | opcional | Título del producto. |
products[].items[].url | string | opcional | Detalles del producto página URL. |
products[].items[].cover | string | opcional | Imagen de la cubierta del producto URL. |
products[].items[].price | string | opcional | Precio actual, con moneda. |
products[].items[].originalPrice | string | opcional | Precio original o precio de la huelga. |
products[].items[].score | string | opcional | Calificaciones de los productos. |
products[].items[].ratingsCount | string | opcional | Número de revisiones. |
products[].items[].describe | string | opcional | Presentación de productos. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.