Saltar al contenido
Beta

Recursos Soporte

Soporte

Cómo pedir ayuda con la API de Totem, qué incluir en una solicitud y qué hacer si se filtra una clave.

Cómo contactarnos

El equipo de Totem atiende las solicitudes de soporte de la API.

  • Desde Totem. Un administrador de tu equipo abre Ayuda en la aplicación de Totem y envía una solicitud de soporte. Es la vía más rápida, porque la solicitud llega vinculada a tu equipo.
  • Por correo electrónico. Escribe a hello@totemstudio.ai. También puede escribir un desarrollador que trabaje para un cliente: indica de qué cliente y de qué integración se trata.

Todavía no hay una página de estado específica de la API. Si la API parece caída, llama a GET /v1/health, que no necesita clave, y cuéntanos qué respondió.

Qué incluir

  • el Totem-Request-Id de la respuesta que falló, si lo trae, y su cabecera Totem-Release, si la trae;
  • la hora de la petición, en UTC;
  • el método y la ruta, como GET /v1/sync/changes;
  • el estado HTTP y el code del error;
  • el nombre de la integración y los cuatro últimos caracteres de su clave;
  • el identificador del equipo (team_…) y los identificadores de los registros afectados.

Qué no enviar nunca

No envíes nunca una clave secreta, ni entera ni en parte más allá de sus cuatro últimos caracteres. No pegues datos personales de las respuestas, como nombres, teléfonos o direcciones de correo electrónico: con los identificadores de los registros y de las peticiones tenemos suficiente para investigar.

Si se filtra una clave

Elige Rotar clave de inmediato en Ajustes → Desarrolladores y marca Esta clave puede estar comprometida, para que la antigua se revoque sin periodo de gracia. Después indícanos el nombre de la integración, cuándo crees que se filtró la clave y quién o qué tenía acceso a ella. En Autenticación se explica cómo rotar y revocar.

Para informar de una posible vulnerabilidad en la API, en esta documentación o en el SDK de TypeScript, escribe en privado a hello@totemstudio.ai, como se explica en Seguridad y datos personales.

Avisos

La API está en Beta. El registro de cambios recoge los cambios bajo la fecha en que se publicaron, y en Convenciones se explica qué puede cambiar durante la Beta.

Versión de la API 1.0a