MenteX Logo
← Volver al inicio

Documentación de la API pública

Referencia de los endpoints que alimentan el formulario de contacto, el cotizador y las herramientas de diagnóstico con IA de MenteX. Generada desde los mismos esquemas que validan cada petición.

get/api/health

Estado del servicio

Comprobación ligera de disponibilidad de la API pública. Sin dependencias externas.

Respuestas

  • 200Servicio operativo.
  • 401Se envió un Bearer token inválido o expirado. La cabecera WWW-Authenticate enlaza la metadata del recurso (RFC 9728). Sin cabecera Authorization la petición se atiende como anónima.
  • 429Límite excedido: 10 peticiones por minuto por IP sin token, 60 por cliente con scope api:extended.
post/api/lead

Registrar solicitud de contacto B2B

Recibe el formulario de contacto del sitio como application/x-www-form-urlencoded (no JSON). Tras registrar el lead redirige a /gracias (303); ante datos inválidos redirige a la página de origen con el parámetro de error.

Cuerpo de la petición (application/x-www-form-urlencoded)

CampoTipoObligatorio
nombrestring
emailstring (email)
telefonostring
empresastring
tamano_empresa"1-5 empleados" | "6-20 empleados" | "21-50 empleados" | "51-200 empleados" | "Más de 200 empleados"
servicio_requerido"Desarrollo de Software" | "Inteligencia Artificial" | "ERP" | "ERP Recicladoras" | "ERP Logistica" | "Facturacion Electronica" | "Otro"
presupuesto_estimado"Menos de 2,000 usd" | "Entre 2,000 y 5,000 usd" | "Entre 5,000 y 10,000 usd" | "Más de 10,000 usd"
situacion_actualstring
descripcionstring

Respuestas

  • 302Datos inválidos o error de persistencia; redirección con detalle en query string.
  • 303Lead registrado; redirección a /gracias.
  • 401Se envió un Bearer token inválido o expirado. La cabecera WWW-Authenticate enlaza la metadata del recurso (RFC 9728). Sin cabecera Authorization la petición se atiende como anónima.
  • 429Límite excedido: 10 peticiones por minuto por IP sin token, 60 por cliente con scope api:extended.
post/api/cotizacion

Registrar cotización estimada de proyecto

Persiste los parámetros del cotizador interactivo y el rango de inversión estimado.

Cuerpo de la petición (application/json)

CampoTipoObligatorio
nombrestring
emailstring (email)
tipo_proyectostring
complejidadstring
integracionesstring[]No
plazostring
monto_minnumberNo
monto_maxnumberNo

Respuestas

  • 200Cotización registrada.
  • 400Datos de cotización incompletos.
  • 401Se envió un Bearer token inválido o expirado. La cabecera WWW-Authenticate enlaza la metadata del recurso (RFC 9728). Sin cabecera Authorization la petición se atiende como anónima.
  • 429Límite excedido: 10 peticiones por minuto por IP sin token, 60 por cliente con scope api:extended.
  • 500Error al guardar la cotización.
post/api/diagnostico

Diagnóstico de madurez tecnológica con IA

Genera una recomendación personalizada a partir de las respuestas del cuestionario y la persiste.

Cuerpo de la petición (application/json)

CampoTipoObligatorio
nombrestring
emailstring (email)
empresastring
respuestasobject
scorenumber
nivelstring

Respuestas

  • 200Recomendación generada y registrada.
  • 201Recomendación generada; el registro no pudo guardarse.
  • 400Datos de diagnóstico inválidos o incompletos.
  • 401Se envió un Bearer token inválido o expirado. La cabecera WWW-Authenticate enlaza la metadata del recurso (RFC 9728). Sin cabecera Authorization la petición se atiende como anónima.
  • 429Límite excedido: 10 peticiones por minuto por IP sin token, 60 por cliente con scope api:extended.
  • 500Error interno al generar el análisis.
post/api/evaluacion

Evaluación de infraestructura y riesgo con IA

Genera una recomendación de seguridad e infraestructura a partir del cuestionario y la persiste.

Cuerpo de la petición (application/json)

CampoTipoObligatorio
nombrestring
emailstring (email)
respuestasobject
scorenumber
nivel_riesgostring
respuestasNostring[]No

Respuestas

  • 200Recomendación generada y registrada.
  • 201Recomendación generada; el registro no pudo guardarse.
  • 400Datos de evaluación inválidos o incompletos.
  • 401Se envió un Bearer token inválido o expirado. La cabecera WWW-Authenticate enlaza la metadata del recurso (RFC 9728). Sin cabecera Authorization la petición se atiende como anónima.
  • 429Límite excedido: 10 peticiones por minuto por IP sin token, 60 por cliente con scope api:extended.
  • 500Error interno al generar la evaluación.

¿Necesita una integración a medida con sus sistemas?

Hablar con el equipo →