Timesheets.com ahora ofrece una API para uso del cliente. Puede hacer clic aquí para acceder a la primera versión alfa.

Hay algunas cosas a tener en cuenta al hacer uso de la API:

• Todas las solicitudes requieren un encabezado con una clave API y un token de autorización. El token de autorización lo autentica como un usuario específico de su cuenta de Timesheets.com.
• Actualmente, solo el administrador principal está autorizado para generar credenciales de API para sí mismo. Esto es para simplificar la seguridad de la API y las solicitudes que se le envían.
• Demasiados intentos de autenticación fallidos para un token darán como resultado un bloqueo cronometrado de más solicitudes. La API en general tiene un límite de velocidad de cinco solicitudes cada sesenta segundos para cualquier clave de API específica.
• Importante: Trate sus claves/tokens como contraseñas y manténgalas en secreto. Cuando trabaje con la API, use claves/tokens como variables de entorno en lugar de codificarlos en sus programas.

Hay dos métodos para generar credenciales para la API:

1. Cuando haya iniciado sesión en Timesheets.com como administrador principal, vaya a «Herramientas» en el menú de la izquierda.
2. En el menú «Herramientas», navegue hasta «Generar claves API».
3. Utilice el botón ‘Generar credenciales’ para generar una clave de API y un token de autorización. El resultado también contendrá los pares de nombre y valor del encabezado.

OR

1. Use el punto final /auth/token desde el tablero de Taffy (o cualquier otro método que desee)
2. Publique su nombre de usuario y contraseña de administrador principal de Timesheets.com. Si la cuenta está activa y en buen estado, se devolverá una respuesta con los valores de la clave API, el token y el nombre del encabezado.

Una vez que se hayan creado una apikey (clave API) y un token de autorización, envíe los siguientes encabezados con su solicitud:

apikey: [apikey]
x-ts-authorization: [token]

Los nombres de encabezado que se muestran aquí pueden diferir a los que aparecerán en la respuesta al generar las credenciales. Utilice los nombres proporcionados en la respuesta.

Para cualquier otra solicitud en Taffy: abra el punto final, haga clic en Agregar encabezado, pegue el encabezado, configure su solicitud y envíela.

Acerca de las Solicitudes

Para mantener la API simple para el consumo de datos, se han omitido las respuestas complejas y los códigos de error. Todas las solicitudes que se autentiquen con éxito devolverán una respuesta 200. La respuesta indicará errores o los datos solicitados.

La mayoría de los puntos finales (endpoints) devolverán un JSON estructurado de la siguiente manera:

{
errors: [],
data: []
}

Si se detectaron errores en la solicitud (como parámetros faltantes o no válidos), la clave de errores contendrá una lista de mensajes en inglés sencillo. En su mayor parte, estos son los mismos mensajes de error de la interfaz de usuario que vería al utilizar la propia aplicación. Si la matriz de errores está vacía, la clave de datos contendrá los datos solicitados. Esto puede y variará según el punto final.

Todos los datos de consulta se devuelven en formato de columna con una clave de columna que enumera los campos en orden y una clave de datos con los datos correspondientes.

Nota: Algunas claves pueden aparecer en Mayúsculas y otras en CamelCase. Esto se debe a las idiosincrasias en la clasificación automática de datos dentro del marco de la aplicación en el que estamos construidos.