POST
https://api.nexscope.ai/jev/routeEjecutar 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/jev/route |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
intent | string | obligatorio | Una intención de enrutamiento. Se utiliza sólo para el descubrimiento y nunca se convierte en API o la evaluación. Ejemplo: Fetch Amazon product reviews by ASIN so I can analyze customer pain points |
categorySlug | string | opcional | Categoría de catálogo público actual opcional, o jev-evaluación para limitar el descubrimiento a los presets fijos. Ejemplo: amazon-marketplace-intelligence |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
{
"code": 0,
"data": {
"candidates": [],
"catalogVersion": "<catalog version>",
"confidence": 0.91,
"match": {
"docsPath": "/api-docs/amazon-reviews-list?view=api",
"endpoint": "/api/skill-api/v1/skills/amazon-reviews-list/run",
"kind": "skill_api",
"mcpToolName": "nexscope_amazon_reviews_list",
"method": "POST",
"name": "Amazon Reviews List",
"schemaEndpoint": "/api/skill-api/v1/skills/amazon-reviews-list",
"slug": "amazon-reviews-list"
},
"models": [
"<resolved model>"
],
"policyVersion": "jev-routing-v2",
"reason": "matched",
"status": "matched"
},
"msg": "success"
}Campos de respuesta
Nexscope el sobre de respuesta. El router devuelve metadatos de confianza y nunca ejecuta el API o preestablecido de evaluación.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | Cero sobre el éxito; no cero para la validación, acceso, cuota o errores de disponibilidad. |
data | object | obligatorio | Para emparejar, llame al punto final devuelto por separado después de recoger los campos requeridos. Para ambiguo, pida al usuario que aclare y encamine de nuevo. Para no_match, no inventar ni ejecutar una capacidad. |
data.candidates | array | obligatorio | Hasta tres candidatos a la aclaración para un resultado ambiguo. |
data.candidates[] | object | obligatorio | Elemento de data candidates. |
data.catalogVersion | string | obligatorio | Marca de tiempo del catálogo utilizado para esta decisión de enrutamiento. |
data.confidence | number | null | obligatorio | Valor de Confidence usado por esta operación de API. Mínimo: 0 Máximo: 1 |
data.match | any | obligatorio | Valor de Match usado por esta operación de API. |
data.models | array | obligatorio | Versiones de modelos resueltas utilizadas por las etapas de enrutamiento. |
data.models[] | string | obligatorio | Elemento de data models. |
data.policyVersion | string | obligatorio | Versión de política de enrutamiento de propiedad del servidor. |
data.reason | string | obligatorio | Valor de Reason usado por esta operación de API. Permitidos: matched, clarification_required, no_supported_api |
data.status | string | obligatorio | Valor de Status usado por esta operación de API. Permitidos: matched, ambiguous, no_match |
msg | string | obligatorio | Mensaje de respuesta. |
Published data API match
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.match | object | obligatorio | Valor de Match usado por esta operación de API. |
data.match.docsPath | string | obligatorio | Valor de Docs path usado por esta operación de API. |
data.match.endpoint | string | obligatorio | Valor de Endpoint usado por esta operación de API. |
data.match.kind | string | obligatorio | Valor de Kind usado por esta operación de API. Constante: skill_api |
data.match.mcpToolName | string | obligatorio | Valor de Mcp tool name usado por esta operación de API. |
data.match.method | string | obligatorio | Valor de Method usado por esta operación de API. Constante: POST |
data.match.name | string | obligatorio | Valor de Name usado por esta operación de API. |
data.match.schemaEndpoint | string | obligatorio | Valor de Schema endpoint usado por esta operación de API. |
data.match.slug | string | obligatorio | Valor de Slug usado por esta operación de API. |
Fixed JEV use-case match
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.match | object | obligatorio | Valor de Match usado por esta operación de API. |
data.match.docsPath | string | obligatorio | Valor de Docs path usado por esta operación de API. |
data.match.endpoint | string | obligatorio | Valor de Endpoint usado por esta operación de API. |
data.match.kind | string | obligatorio | Valor de Kind usado por esta operación de API. Constante: jev_use_case |
data.match.mcpToolName | string | obligatorio | Valor de Mcp tool name usado por esta operación de API. |
data.match.method | string | obligatorio | Valor de Method usado por esta operación de API. Constante: POST |
data.match.name | string | obligatorio | Valor de Name usado por esta operación de API. |
data.match.schemaEndpoint | string | obligatorio | Valor de Schema endpoint usado por esta operación de API. |
data.match.schemaPointer | string | obligatorio | Valor de Schema pointer usado por esta operación de API. |
data.match.useCase | string | obligatorio | Valor de Use case usado por esta operación de API. |
Opción 3 de una alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.match | null | obligatorio | Nulo por ambiguo y no_match respuestas. |
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.