Ir al contenido

Documentación para desarrolladores

Automatiza Probara: llama a la API REST pública desde CI y scripts, o conecta un cliente MCP para que un agente de IA opere proyectos, suites, casos, ejecuciones y defectos directamente. Cada operación de escritura de la API está controlada por un permiso de organización — un viewer recibe 403 forbidden en toda escritura, y algunas escrituras (como crear un proyecto) requieren un rol owner/admin.

  • Uso del producto en Guías.
  • Prefijo REST: la app web y las integraciones deben usar /api/v1 (por ejemplo GET /api/v1/health). Rutas sin versión (/api/...) responden 404 not_found.
  • Autenticación API — tokens API por organización (Authorization: Bearer) para scripts, y tokens de aplicación de la organización para enviar resultados desde CI; la web sigue con cookies de sesión. El endpoint MCP además acepta tokens de acceso OAuth 2.1 para clientes interactivos.
  • Integraciones CI — envía resultados de pruebas desde cualquier CI con un token de aplicación (planes de pago): elige entre la CLI y los reporters de Playwright, Jest, Cypress, Vitest y Cucumber.
  • CLI — envía resultados JUnit XML desde cualquier CI con @probara/cli.
  • Reporter de Playwright — envía cada intento de Playwright, con sus pasos y adjuntos, con @probara/playwright-reporter.
  • Reporter de Jest — envía cada intento de Jest, con sus pasos, adjuntos y enlaces, y ejecuta solo las pruebas de una ejecución de Probara, con @probara/jest-reporter.
  • Reporter de Cypress — envía cada intento de Cypress, con sus pasos, las capturas de los fallos y sus enlaces, y ejecuta solo las pruebas de una ejecución de Probara, con @probara/cypress-reporter.
  • Reporter de Vitest — envía cada intento y cada repetición de Vitest, con sus pasos, adjuntos y enlaces, y ejecuta solo las pruebas de una ejecución de Probara, con @probara/vitest-reporter.
  • Referencia REST — resumen (URL base, errores, paginación).
  • Referencia interactiva (v1) — visor OpenAPI 3.1.
  • Servidor MCP — conecta cualquier cliente compatible con MCP (Claude.ai, Claude Code, Cursor, ChatGPT) a https://app.probara.net/mcp con OAuth 2.1 o un token API.
  • Referencia de herramientas MCP — la lista completa y generada de cada herramienta que expone el servidor, regenerada desde el registro del worker para que nunca diverja.
  • Aprovisionamiento SCIM — el endpoint SCIM 2.0 que un proveedor de identidad llama para aprovisionar personas y grupos, en el plan Enterprise.
  • Markdown para agentes — cada guía y cada página para desarrolladores también se sirve como Markdown plano: cambia la barra final por .md (por ejemplo /es/developers/authentication.md). /llms.txt las lista todas, para que un agente de código lea la documentación sin interpretar HTML.
TemaEstado
Autenticación APIDisponible
Referencia REST (resumen)Disponible
Referencia interactiva (v1)Disponible
Servidor MCPDisponible
Referencia de herramientas MCPDisponible
Reporters / CIDisponible
CLI ProbaraDisponible
Aprovisionamiento SCIM (plan Enterprise)Disponible

Cuando se publique una nueva capacidad, esta sección añadirá su autenticación, ejemplos y referencia estable desde los esquemas Zod del monorepo.