TaskJunction Open API Description

This page will provide instructions on how to interact with the online TaskJunction API. The API can be used to integrate TaskJunction data and functionality with other software and platforms. This API is free to use and doesn't require any prior registration.

To integrate TaskJunction with .Net projects use the .Net Client Library at found at CodePlex.
Java library is available at github.

Web service architecture

The architecture of TaskJunction is build upon a RESTful web service architecture where all resources are mapped to urls and actions are mapped to HTTP verbs. Data is retrieved as either JSON or XML. A resouce can be a project, a task, a user etc.

Verb	Example	Description
GET	/projects	Receive all projects
GET	/projects/654346789	Receive the project with id 654346789
POST	/projects	Create a new project
PUT	/projects/654346789	Replace the project with id 654346789
DELETE	/projects/654346789	Delete the project with id 654346789

When sending data the content type can either be form encoded or JSON encoded. If using JSON encoding you will need to add a Content-Type header with the value application/json to your request. JSON encoding is recommended over form encoding.

Authentication

All interactions are made in the context of a user account. The user account used to log in to the website can also be used to access resources through the web service API.

You authenticate by using the POST verb on the resource session.

POST http://www.taskjunction.com/sessions
{email: "user@domain.com", password: "SecretPassword123", apiversion: "apiv1"}

If the login is successful a 200 OK error code is returned. Included in the response is a cookie session id which needs to be used for all subsequent requests.
Don't forget the apiversion parameter. If not included some requests might not work as intended.

Resources

Tasks

GET http://www.taskjunction.com/tasks?project_id=654346789
GET http://www.taskjunction.com/tasks?iteration_id=9876345678
GET http://www.taskjunction.com/tasks/458748947
POST http://www.taskjunction.com/tasks
PUT http://www.taskjunction.com/tasks/458748947
DELETE http://www.taskjunction.com/tasks/458748947

Additional filter parameters can be used to filter the list of tasks.

task_status_1
task_status_2
task_status_3
task_status_4
task_status_5
owner_user_id
search

GET http://www.taskjunction.com/tasks?project_id=654346789&task_status_1=1&task_status_2=0&search=Dev

Projects

GET http://www.taskjunction.com/projects
GET http://www.taskjunction.com/projects/654346789
POST http://www.taskjunction.com/projects
PUT http://www.taskjunction.com/projects/654346789
DELETE http://www.taskjunction.com/projects/654346789

Iterations

GET http://www.taskjunction.com/iterations
GET http://www.taskjunction.com/iterations/9876345678
POST http://www.taskjunction.com/iterations
PUT http://www.taskjunction.com/iterations/9876345678
DELETE http://www.taskjunction.com/iterations/9876345678

ProjectMembers

GET http://www.taskjunction.com/project_members?project_id=654346789
GET http://www.taskjunction.com/project_members/86589098
POST http://www.taskjunction.com/project_members
PUT http://www.taskjunction.com/project_members/86589098
DELETE http://www.taskjunction.com/project_members/86589098

IterationStatuses

GET http://www.taskjunction.com/iteration_statuses

TaskPriorities

GET http://www.taskjunction.com/task_priorities

TaskStatuses

GET http://www.taskjunction.com/task_statuses

TaskTypes

GET http://www.taskjunction.com/task_types

Need help?

If you need help using the TaskJunction REST API please don't hesitate to write an e-mail.