• 1-800-224-1462

Faqs

General Questions

What do I need to connect a Task Management System to API2Task?

API2Task API allows to add new task management systems by using the application resource with the POST method. Once the system is successfully added, a key for the added system is returned. This key is to be used to send requests to API2Task. The user key, system type and system credentials will be passed and held there.

When adding a new TMS into the system, you will be asked to provide certain access API parameters.
The “type” parameter is need to be set depending on supported paltform.
The “credentials” parameter differ depending on a platform type and contain blocks of provided parameter pair – the “name” and the “value”.
The “description” parameter is a TMS information to your notion.
For example, parameter body for adding new “Jira” TMS should looks as follows:

{
  "type": "Jira",
  "credentials": [
    {
      "name": "url",
      "value": "https://testapi2.atlassian.net/"
    },
    {
      "name": "user",
      "value": "admin"
    },
    {
      "name": "password",
      "value": "12345678"
    }
  ],
  "description": "Test Jira TMS"
}

The parameters differ depending on a TMS type and are as follows:


JIRA

type – Jira

url – TMS URL (example: https://domain.atlassian.net/)

user – your user name for auth into Jira (example: my-tms-user-name)

password – your password for auth into Jira (example: my-tms-password)


BITRIX24

type – Bitrix24

url – TMS URL (example: https://domain.bitrix24.com/)

access_token – your Bitrix24 parameter properly required for access to authorization (example: nyxnbk6ropm4owlaaya1kd8qhe7bqrk7)

refresh_token – your Bitrix24 refresh_token API REST required for authorization extension (example: b6v26ewuvumjjal1yj2qimdyjvgnsnkk)


For more information on how to get your API access parameters visit the Bitrix24 FAQ section of the Bitrix24 platform.


ASANA

type – Asana

token – Asana personal access token (example: 0/333538675f251d1a3894834fcaaeb339)

workspace – Asana workspace id (example: 26564754309493)


For more information on how to get your API access parameters visit the Asana FAQ section of the Asana platform.


TRELLO

type – Trello

key – Trello key (example: c51be6aa063e298ad91d43ba3e05e0a2)

token – Trello token (example: c354612babb9121df8ffd452452af2284048be82c8ab65be3bf80f74c7a28f92)


For more information on how to get your API access parameters visit the Trello FAQ section of the Trello platform.

Permalink.

How do I report a bug or request a new feature?

You can report a bug or request a new feature by submitting the form.

In case you would like to let us know what platform you believe we should develop an integration with, let us know by requesting an integration.

Permalink.

How much does the service cost?

We believe that your business needs are unique and this makes a personalized pricing approach a best option to meet them best. To find out more information on what pricing would suit your specific business case, request for quote with your contact details included. We will try our best to respond as soon as possible to discuss the details.

Permalink.

Can I be sure of data security using API2Task?

API2Task service respects its clients’ information and takes serious measures to ensure it is safely stored and transmitted. We guarantee your data will be protected from unauthorized access and kept confidential. Read more on our Privacy Policy page.

Permalink.

What is an API?

API (Application Programming Interface) is what you integrate with to get an ability to retrieve and use the data from another service’s or platform’s database. It works as a medium that makes it possible for two systems to “communicate”.

Permalink.

Getting Started

How can I find my Bitrix24 Access API Parameters?

Here are the access parameters you need to connect Bitrix24 with API2Task:

type – Bitrix24

url – TMS URL

(example: https://testapi.bitrix24.com/)

access_token – your Bitrix24 access_token API REST with scopes “calendar, disk, telephony, crm, im, user, entity, task, tasks_extended, bizproc, mailservice, log, sonet_group, department”

(example: s6re4n8qilgqab41x1xcrf63z1esrzig)

refresh_token – your Bitrix24 refresh_token API REST

(example: s6re4n8qilgqab41x1xcrf63z1esrzig)

To obtain access_token and refresh_token:

    1. A Bitrix24 application uses client_id to get the value of code, which is imperative to get the authorization token. A user opens the following address in a browser:
      https://intranet_name.bitrix24.com/oauth/authorize/?response_type=code&client_id=app_ID&redirect_uri=app_URL
      intranet_name – it is a name of your Bitrix24 network.
      The browser will now redirect to the application URL passing the first authentication code (the code).
    2. The application uses clent_id, client_secret and code to get the values of access_code and refresh_token.
      The application sends a request: https://intranet_name.bitrix24.com/oauth/token/?grant_type=authorization_code&client_id=app_ID&client_secret=app_secret_code
      &code=first_authentication_code&scope=application_permissions&redirect_uri=application_URL
      The server will reply with a JSON string like:
      "access_token":"authentication_code","expires_in":3600,"scope":"granted_permissions","refresh_token":"authentication_refresh_code","domain":"Intranet_name","member_id":"Intranet_ID"}
    3. The application uses access_code to send REST requests until the access code is expired.
      https://intranet_name.bitrix24.com/rest/user.current?auth=authentication_code
    4. access_code will expire in an hour. The application can then use refresh_token to get a new access_code.
      https://intranet_name.bitrix24.com/oauth/token/?grant_type=refresh_token&client_id=app_ID&client_secret=app_secret_code
      &refresh_token=authentication_refresh_code&scope=granted_permission&redirect_uri=app_URL
    5. If refresh_token is still valid (was obtained less than a month ago), the application gets new valid access_code and refresh_token and proceeds to the step 3.
    6. If, however, refresh_token has expired, a user will have to authenticate again manually next time a REST request is going to be sent out.
In fact, a user intervention is only required at the first step. If the application is in frequent use, at least once per month, authorization will refresh in silent mode indefinitely. Notice that this algorithm is only applied to external applications. Hosted applications obtain and refresh authorization automatically.

Permalink.

How can I find my Asana Access API Parameters?

Here are the access parameters you need to connect Asana with API2Task:

type – Asana

token – Asana personal access token

(example: 333538675f251d1a3894834fcaaeb337)

workspace id – your Asana workspace id you wish to working with

(example: 102545609240695)


TO REVIEW ASANA CONNECT APPLICATIONS YOU’VE AUTHORIZED, DO THE FOLLOWING:

  1. Click your profile photo from the top bar and select My Profile Settings
  2. Navigate to the Apps tab
  3. Review the Authorized section
Asana Access API Parameters

Personal Access Tokens


Personal access tokens provide individuals with a low friction means to access the Asana API when writing scripts, working with command line utilities, or prototyping applications. In most cases you should not provide personal access tokens to applications you do not know or fully trust the creator of.

Applications that support accessing Asana on behalf of many users should make use of Asana Connect.


To create a personal access token for yourself:

  1. Click your profile photo from the top bar and select My Profile Settings
  2. Navigate to the Apps tab
  3. Select Personal Access Token
  4. Add a Description
  5. Click the Create button
You are required to enter a description for each access token in order to easily remember its individual purpose. You are also encouraged to regularly review and deauthorize access tokens you no longer want or need.


To get your workspace id, go to https://app.asana.com/api/1.0/workspaces (ensure you are logged into Asana when viewing this page). This will display a JSON object of your workspace id and name. Copy the workspace id corresponding to the relevant workspace name.

Permalink.

How can I find my Trello Access API Parameters?

Here are the access parameters you need to connect Trello with API2Task:

type – Trello

key – Trello access key

(example: c51be6aa063e298ad91d43ba3e05e0a2)

token – Trello token

(example: c354612babb9121df8ffd452452af2284048be82c8ab65be3bf80f74c7a28f92)


API KEYS


API Key can be found at the https://trello.com/app-key page.
API Token can be found at the https://trello.com/1/authorize?expiration=never&scope=read,write,account&response_type=token&name=Server%20Token&key=app_key page, where “app_key” is value of “key”, described above.

Permalink.

Chat now
Welcome! I'm here to help with any questions
×
Need Help?

Schedule a Call

Still have questions? Let us know when you have time to discuss the business advantages you can gain from integration with API2Task with our expert.

Time zone: UTC +0

Your browser is out-of-date!

Update your browser to view this website correctly.Update my browser now

×