Para la referencia completa de endpoints, autenticación, payloads y códigos de error, consulta la Referencia de la API.
Cómo funciona
Cada token es una credencial personal de aplicación (no está vinculada a un usuario humano) que autentica solicitudes a la API REST de Tartini. Creas tantos tokens como necesites, uno por integración, por ejemplo, y revocas individualmente cuando alguna clave se filtra o un sistema antiguo se desactiva. La autenticación sigue el estándar Bearer Token en el header HTTP:Crear un token
1
Abre el modal de creación
Haz clic en Criar Token (Crear Token), en el encabezado de la página (o en el botón del estado vacío, antes de que exista algún token).
2
Completa los datos
- Nome (Nombre) (obligatorio): identificador corto, ej.:
Integração ERP. - Descrição (Descripción) (opcional): texto libre para describir el propósito del token.
3
Copia el token
Después de la creación, un modal muestra el token completo. Cópialo y guárdalo en un lugar seguro: por motivos de seguridad, Tartini no volverá a mostrar ese valor.
Ver y gestionar tokens
La página lista todos los tokens creados por la Empresa en tarjetas, con:Eliminar un token
Cada tarjeta tiene un botón de papelera (tooltip Excluir token / Eliminar token). Al hacer clic se abre una confirmación. Al confirmar, el token se revoca y deja de autenticar llamadas a la API.Buenas prácticas
- Tokens por integración: como la eliminación de cada token es independiente, integraciones distintas pueden usar tokens distintos, sin afectar a las demás al eliminar una de ellas.
- Seguridad del token: mantén el valor en un lugar seguro y nunca lo compartas, tal como indica el propio aviso de la pantalla.
- Campo “Último uso”: ayuda a identificar tokens sin uso reciente al revisar cuáles siguen siendo necesarios.