Inicio rápido
La API pública no pide llave, cuenta ni registro. Prueba estas tres llamadas:
- curl https://mce.mediasource.mx/api/v1/metodo
- curl "https://mce.mediasource.mx/api/v1/prompts?herramienta=relume"
- curl -X POST https://mce.mediasource.mx/api/v1/diagnostico -H "Content-Type: application/json" -d '{"ruta":"equipo","respuestas":{"icp":3,"proceso":7,"mensaje":0}}'
Especificación OpenAPI 3.1: https://mce.mediasource.mx/openapi.json. Catálogo de APIs (RFC 9727): https://mce.mediasource.mx/.well-known/api-catalog.
Autenticación
- API pública: sin autenticación. Es de solo lectura y no guarda nada, así que no hacen falta llaves de API.
- Contexto de una empresa: solo por el conector MCP (https://mce.mediasource.mx/api/mce/mcp), con OAuth 2.1, PKCE (S256) y registro dinámico de clientes (RFC 7591). Tampoco usa llaves: la persona entra con su correo y aprueba la conexión. Requiere plan Esencial o Pro.
- Alta propia, sin hablar con ventas: https://mce.mediasource.mx/entrar con cualquier correo y un código de seis dígitos. El plan Gratis no pide tarjeta.
Endpoints
Base: https://mce.mediasource.mx/api/v1. Todas las respuestas son JSON (UTF-8) y aceptan CORS desde cualquier origen.
- GET /api/v1 (getApiIndex): Índice de la API.
- GET /api/v1/metodo (getMethod): El método completo.
- GET /api/v1/bloques (listBlocks): Los bloques de contexto (Aclarar).
- GET /api/v1/bloques/{id} (getBlock): Un bloque y lo que alimenta.
- GET /api/v1/documentos (listDocuments): Los documentos (Accionar).
- GET /api/v1/metricas (listMetrics): Las métricas (Acelerar).
- GET /api/v1/diagnostico/preguntas (getDiagnosticQuestions): Las preguntas del diagnóstico.
- POST /api/v1/diagnostico (scoreDiagnostic): Calificar un diagnóstico.
- GET /api/v1/prompts (listPrompts): El catálogo de prompts.
- GET /api/v1/prompts/{id} (getPrompt): Un prompt del catálogo.
- GET /api/v1/planes (listPlans): Planes y precios.
Parámetros, cuerpos y esquemas de respuesta, en https://mce.mediasource.mx/openapi.json.
Errores
Todo error es JSON con la misma forma: { "error": { "code", "status", "message", "hint", "docs" } }. code es estable para decidir en código; message dice qué pasó y hint, cómo corregirlo. Algunos traen details (por ejemplo, qué respuestas del diagnóstico no son válidas).
- 404 not_found: El recurso no existe.
- 405 method_not_allowed: El método HTTP no se acepta en esta ruta.
- 400 invalid_parameter: Un parámetro de la consulta no es válido.
- 400 invalid_json: El cuerpo no es JSON válido.
- 415 unsupported_media_type: El cuerpo debe enviarse como application/json.
- 413 payload_too_large: El cuerpo pasa del tamaño permitido.
- 422 invalid_answers: Las respuestas del diagnóstico no son válidas.
Una ruta de /api que no existe también responde 404 en JSON, nunca una página HTML.
Pruebas sin riesgo
No hay un entorno aparte porque no hace falta: la API pública no escribe nada. El diagnóstico calcula el puntaje con reglas y no lo guarda, así que puedes llamarlo cuantas veces quieras en producción.
Para probar el método completo con una empresa, el plan Gratis basta; el conector MCP se activa con Esencial o Pro.
Versiones y caché
- La versión va en la ruta (/api/v1). Un cambio incompatible saldría en una versión nueva; /api/v1 se queda como está.
- Las respuestas GET se guardan una hora en el CDN: el catálogo cambia con cada versión del método, no con cada visita.
Conector MCP
Para leer y proponer cambios al contexto comercial de una empresa desde Claude, ChatGPT o cualquier cliente MCP: https://mce.mediasource.mx/mcp. Tarjetas del servidor: https://mce.mediasource.mx/.well-known/mcp.json y https://mce.mediasource.mx/.well-known/mcp/server-card.json.
Para agentes de IA
- https://mce.mediasource.mx/llms.txt: el índice del sitio y del método.
- https://mce.mediasource.mx/agents.md: cuándo usar el método y cómo llamarlo.
- Cualquier página pública responde en Markdown si la pides con Accept: text/markdown.
