timr can be integrated into existing systems via our API.
From various requests from our customers, we have learned that the tasks for the integration are usually similar, but the systems used are different.
Recently, we started to develop a system called "timrLink" that simplifies this integration and thus reduces the effort for the connection.
Forther information on the API itself can be found here.
timrLink:
timrLink is an "executable file" (exe) that executes certain sync tasks each time it is called. The call can be executed periodically, eg via "Scheduled Tasks".
Technically, timrLink is a .NET core application that is made available via open source. A first version can be found on GitHub: https://github.com/troii/timrlink.net
On the timr side timrLink talks to the timr API, the connection to the customer system is implemented by the customer.
The integration on your side (with an ERP, database, ...) you would add yourself then as a project and probably keep only internally.
We are still a bit in the beginning with timrLink and therefore there is no documentation yet ... so if you have any questions please contact us anytime!
Current state:
This project creates an application that performs a sync with the timr API on every call.
Certain standard actions are already implemented as CLI (Command Line Interface) (see https://github.com/troii/timrlink.net/tree/master/timrlink.net.CLI/Actions):
1. tasks import from csv
2. project time import from csv and Excel
Extending your own actions:
Analogous to the existing base implementation, custom actions can be extended by yourself at any time. You can fork and clone the project and customize the existing CLI application or create an additional project where you implement your own integration logic based on the core project.
For configuration you have to assign https://github.com/troii/timrlink.net/blob/master/timrlink.net.CLI/config.json with your timr identifier and API token (see Administration/Settings in timr).
The underlying timr API (https://timrsync.timr.com/timr/timrsync.wsdl) supports much more functions. Step by step we will also offer the other timr API functions as a service in timrLink.
Already available services:
Already available services can be found here: https://github.com/troii/timrlink.net/tree/master/timrlink.net.Core/Service
1. Tasks Service:
https://github.com/troii/timrlink.net/blob/master/timrlink.net.Core/Service/TaskService.cs
Can be used to query, create as well as update tasks from timr.
2. Working time service
https://github.com/troii/timrlink.net/blob/master/timrlink.net.Core/Service/IWorkTimeService.cs
Can be used to query and create working time from timr.
3. Project time service:
https://github.com/troii/timrlink.net/blob/master/timrlink.net.Core/Service/ProjectTimeService.cs
Can be used to create project times in timr.
Due to the open source approach, a customer can also implement a service that does not yet exist but is needed and (optionally) make it available to the general public.
Comments
0 comments
Article is closed for comments.