1.0.0 • Published 8 years ago

timeular_public_api_unofficial v1.0.0

Weekly downloads
1
License
Unlicense
Repository
-
Last release
8 years ago

timeular_public_api

TimeularPublicApi - JavaScript client for timeular_public_api Welcome to the documentation of Timeular Public API v1. You can try all requests here, in documentation, with use of Try it out button (available in each endpoint description after folding it out). Most of endpoints are secured. In order to access them you have to provide Access Token. To do so, click on Authorize button below and provide Bearer <your_access_token> as a value for Authorization request header. To obtain Access Token you have to sign-in with pair of API Key and API Secret first. API Key & API Secret can be generated on Profile website or, if you have Access Token already, with POST request to /developer/api-access. Warning: authentication flow may change soon due to active development of Timeular and its API. If you have any questions, please visit Support page and ask them there. Happy API browsing! This SDK is automatically generated by the Swagger Codegen project:

  • API version: 1
  • Package version: 1
  • Build package: io.swagger.codegen.languages.JavascriptClientCodegen

Installation

For Node.js

npm

To publish the library as a npm, please follow the procedure in "Publishing npm packages".

Then install it via:

npm install timeular_public_api --save
Local development

To use the library locally without publishing to a remote npm registry, first install the dependencies by changing into the directory containing package.json (and this README). Let's call this JAVASCRIPT_CLIENT_DIR. Then run:

npm install

Next, link it globally in npm with the following, also from JAVASCRIPT_CLIENT_DIR:

npm link

Finally, switch to the directory you want to use your timeular_public_api from, and run:

npm link /path/to/<JAVASCRIPT_CLIENT_DIR>

You should now be able to require('timeular_public_api') in javascript files from the directory you ran the last command above from.

git

If the library is hosted at a git repository, e.g. https://github.com/YOUR_USERNAME/timeular_public_api then install it via:

    npm install YOUR_USERNAME/timeular_public_api --save

For browser

The library also works in the browser environment via npm and browserify. After following the above steps with Node.js and installing browserify with npm install -g browserify, perform the following (assuming main.js is your entry file, that's to say your javascript file where you actually use this library):

browserify main.js > bundle.js

Then include bundle.js in the HTML pages.

Webpack Configuration

Using Webpack you may encounter the following error: "Module not found: Error: Cannot resolve module", most certainly you should disable AMD loader. Add/merge the following section to your webpack config:

module: {
  rules: [
    {
      parser: {
        amd: false
      }
    }
  ]
}

Getting Started

Please follow the installation instruction and execute the following JS code:

var TimeularPublicApi = require('timeular_public_api');

var api = new TimeularPublicApi.AuthenticationApi()

var opts = { 
  'aPIKeyAndAPISecret': new TimeularPublicApi.DeveloperSignInRequest() // {DeveloperSignInRequest} API Key and API Secret
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.developerSignIn(opts, callback);

Documentation for API Endpoints

All URIs are relative to https://api.timeular.com/api/v1/

ClassMethodHTTP requestDescription
TimeularPublicApi.AuthenticationApideveloperSignInPOST /developer/sign-inSign-in with API Key & API Secret
TimeularPublicApi.AuthenticationApigetApiKeyGET /developer/api-accessFetch API Key
TimeularPublicApi.AuthenticationApigetApiKey_0POST /developer/api-accessGenerate new API Key & API Secret
TimeularPublicApi.IntegrationsApigetIntegrationGET /integrationsList enabled Integrations
TimeularPublicApi.ProfileApigetProfileGET /user/profileFetch User's Profile
TimeularPublicApi.TimeTrackingActivitiesApiarchiveActivityDELETE /activities/{activityId}Archive an Activity
TimeularPublicApi.TimeTrackingActivitiesApiassignActivityToDeviceSidePOST /activities/{activityId}/device-side/{deviceSide}Assign an Activity to Device Side
TimeularPublicApi.TimeTrackingActivitiesApicreateActivityPOST /activitiesCreate an Activity
TimeularPublicApi.TimeTrackingActivitiesApieditActivityPATCH /activities/{activityId}Edit an Activity
TimeularPublicApi.TimeTrackingActivitiesApigetActivitiesGET /activitiesList all Activities
TimeularPublicApi.TimeTrackingActivitiesApigetArchivedActivitiesGET /archived-activitiesList all Archived Activities
TimeularPublicApi.TimeTrackingActivitiesApigetTagsAndMentionsOfActivityGET /activities/{activityId}/tags-and-mentionsFetch Tags & Mentions of given Activity
TimeularPublicApi.TimeTrackingActivitiesApiunassignActivityFromDeviceSideDELETE /activities/{activityId}/device-side/{deviceSide}Unassign an Activity from a Device Side
TimeularPublicApi.TimeTrackingCurrentTrackingApieditTrackingPATCH /tracking/{activityId}Edit Tracking
TimeularPublicApi.TimeTrackingCurrentTrackingApigetCurrentTrackingGET /trackingShow current Tracking
TimeularPublicApi.TimeTrackingCurrentTrackingApistartTrackingPOST /tracking/{activityId}/startStart Tracking
TimeularPublicApi.TimeTrackingCurrentTrackingApistopTrackingPOST /tracking/{activityId}/stopStop Tracking
TimeularPublicApi.TimeTrackingDevicesApiactivateDevicePOST /devices/{deviceSerial}/activeActivate a Device
TimeularPublicApi.TimeTrackingDevicesApiactivateDevice_0PATCH /devices/{deviceSerial}Edit a Device
TimeularPublicApi.TimeTrackingDevicesApideactivateDeviceDELETE /devices/{deviceSerial}/activeDeactivate a Device
TimeularPublicApi.TimeTrackingDevicesApidisableDevicePOST /devices/{deviceSerial}/disabledDisable a Device
TimeularPublicApi.TimeTrackingDevicesApieanbleDeviceDELETE /devices/{deviceSerial}/disabledEnable a Device
TimeularPublicApi.TimeTrackingDevicesApiforgetDeviceDELETE /devices/{deviceSerial}Forget known Device
TimeularPublicApi.TimeTrackingDevicesApigetKnownDevicesGET /devicesList all known Devices
TimeularPublicApi.TimeTrackingReportsApigenerateCsvReportGET /report/{startTimestamp}/{stopTimestamp}Generate CSV Report
TimeularPublicApi.TimeTrackingTimeEntriesApicreateTimeEntryPOST /time-entriesCreate Time Entry
TimeularPublicApi.TimeTrackingTimeEntriesApideleteTimeEntryDELETE /time-entries/{timeEntryId}Delete a Time Entry
TimeularPublicApi.TimeTrackingTimeEntriesApieditTimeEntryPATCH /time-entries/{timeEntryId}Edit a Time Entry
TimeularPublicApi.TimeTrackingTimeEntriesApigetTimeEntriesInRangeGET /time-entries/{stoppedAfter}/{startedBefore}Find Time Entries in given range
TimeularPublicApi.TimeTrackingTimeEntriesApigetTimeEntryGET /time-entries/{timeEntryId}Find Time Entry by its ID

Documentation for Models

Documentation for Authorization

AuthorizationHeader

  • Type: API key
  • API key parameter name: Authorization
  • Location: HTTP header