Docs

Referencia de la API

La API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Empieza aquí
  2. Leer
  3. Enviar y administrar

Motor Nube Todo lo que Sypnia sabe de tu app está en esta API: los problemas con su causa, las sesiones y sus grabaciones, las trazas, el rendimiento, la disponibilidad, las alertas. La app, la Consola, el servidor MCP y la CLI están hechos sobre ella, así que todo lo que muestran lo puede leer tu propio código.

Es la misma API en un motor alojado por ti y en Sypnia Cloud. Un endpoint que existe solo en uno lo dice con una insignia.

Terminal
curl "https://api.sypnia.com/v1/problems?status=open" \
  -H "Authorization: Bearer $SYPNIA_API_TOKEN"
URL basehttps://api.sypnia.com/v1 en Sypnia Cloud, <tu URL base>/v1 en tu motor
CredencialesUn token de API (sps_…) para leer y administrar; una llave de ingesta (spk_…) para enviar; el token raíz en tu propio motor
FormatoJSON de entrada y de salida. Fechas en UTC
Contratospec/openapi.yaml en el repositorio de la documentación, OpenAPI 3.1. Estas páginas se generan a partir de él

Los nombres de endpoints, parámetros, campos y valores están en inglés y no se traducen. Los ejemplos de respuestas muestran los datos tal como los devuelve la API.

Empieza aquí

  • Resumen y autenticación

    La URL base, las tres credenciales y sus permisos, y los endpoints que cubren todo un proyecto.
  • Errores, límites, paginación

    La única forma de error, los límites de peticiones, los cursores, los rangos de tiempo, la idempotencia, las versiones de la API.

Leer

  • Problemas

    Lista problemas, trae uno con todo su contexto, el prompt listo, y márcalo como resuelto.
  • Sesiones y grabaciones

    Sesiones, su línea de tiempo, su grabación, personas y cuentas.
  • Trazas

    Una petición, del navegador a las llamadas detrás de la API.
  • Rendimiento

    Métricas de páginas, llamadas a la API, mapas de clics, fallas de formularios, sugerencias semanales.
  • Disponibilidad

    Comprobaciones, su estado y sus resultados.
  • Alertas y webhooks

    Alertas, las reglas que las crean y webhooks firmados.

Enviar y administrar

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar