Integration guidesTools and SDKs

Tools and SDKs

Clients you can use to try the TimeLog APIs without writing code, and the .NET SDKs on GitHub.

You do not need to write code to see how an API behaves. Pick a client below, make a few calls, then build.

Ready-to-run collections for Bruno, a free, open-source API client. Every request is already built and has a test that tells you whether the call worked.

Transactional API collection

One folder per service, split into reads and writes. The token is handled for you.

Reporting API collection

One folder per entity, split into raw extracts and short lists.

For the REST API, use the playground on each operation page in the REST API tab, or any HTTP client with a bearer token.

SoapUI

SoapUI builds every request of a SOAP API from its service description (WSDL).

Build the WSDL URL

Transactional: the service endpoint followed by ?wsdl, for example https://app{server-number}.timelog.com/{account}/WebServices/Security/V1_2/SecurityServiceSecure.svc?wsdl. Reporting: https://app{server-number}.timelog.com/{account}/Service.asmx?WSDL.

Create a SOAP project

In SoapUI, choose SOAP in the toolbar, enter a project name and the WSDL URL, and click OK. SoapUI creates the endpoints and operations from the WSDL.

Create a request

Right-click an operation and choose New Request. SoapUI generates the request body.

Fill in and send

Enter the parameters, including the credentials (Reporting) or the token (Transactional), and click the run button. The answer appears in the Response pane.

Postman

Reporting API. Postman can import the WSDL directly:

  1. Choose Import, open the Link tab, enter …/Service.asmx?WSDL and click Continue, then Import.
  2. Open an operation from the new collection, fill in siteCode, apiID, apiPassword and the other parameters in the body, and click Send.

Transactional API. Build the request by hand:

  1. Create a POST request to the service endpoint, for example …/SecurityServiceSecure.svc.
  2. Add the headers Content-Type: text/xml; charset=utf-8 and SOAPAction with the operation's SOAPAction. Each operation page lists it.
  3. In Body, choose raw and XML, and paste the request envelope from the operation page.
  4. Click Send, and check ResponseState in the answer.

REST API. In the request's Authorization tab, choose Bearer Token and paste your personal access token.

.NET SDKs

TimeLog publishes .NET SDKs for the Transactional and Reporting APIs on GitHub, in TimeLog/TimeLogApiSdk. The APIs do not need .NET: the SDKs are a convenience, and their source shows constructs you can copy to other languages.

ProjectWhat it is
TimeLog.TransactionalAPI.SDKTransactional API client, including token handling across services.
TimeLog.ReportingAPI.SDKReporting API client, with typed default values for parameters.
TimeLog.ReportingApi.ExporterA console application that exports Reporting API data to XML or CSV without code.
TimeLog.API.ConsoleAppSimple examples that use both SDKs.

Ready-built libraries are in the repository's Deploy folder.

To be notified when the APIs or their documentation change, choose Watch on the GitHub repository.

Was this page helpful?