Web Services API Documentation

This document describes the list of SwiftKanban Web services interface definitions that are available for enterprises to integrate with SwiftKanban. We are continuously growing the list of web services based on the requirements expressed by customers and new features being added to the product. So if any web service expected are not found mentioned here, feel free to contact us at This e-mail address is being protected from spambots. You need JavaScript enabled to view it. and we are looking at adding those.
 

Platform

The link https://login.swiftkanban.com/axis2/services/KanbanCardService?wsdl opens our WSDL to access card services. These web services can be used on any Operating System and any Web Service client capable of handling SOAP 1.1 or SOAP 1.2 protocol.

Note: The web services are accessible via the public Digite Service Provider Host https://login.swiftkanban.com/axis2 

To view the list of functions that can be performed on a card, click Services, and then click KanbanCardService. IT opens the WSDL page.where you can access all web services related to the card functions.

Authentication

SwiftKanban Web Service uses username token for authentication. It is a policy-based configuration that follows the WS-Security Policy Language to establish the security requirements of the Web service.

To understand the WS-Security Police, please refer to http://wso2.org/library/3132. Specifically, the UsernameToken WS-SecurityPolicy is applied which conveys security credentials through username and password information as part of the WS-Security headers.


Port KanbancardServiceSOAP11port/12port Port type

 

Locationhttps://login.swift-kanban.com/axis2/services/KanbanCardService.KanbancardServiceSOAP11port
Protocol
SOAP
Transport protocol
SOAP over HTTP


Provide the header information in the soapenv header section as given below. Also provide the username and password in specific tags.

SOAP 1.1 Protocol
<soapenv:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="Timestamp-12468716">...</wsu:Timestamp>
<wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602">
<wsse:Username> This e-mail address is being protected from spambots. You need JavaScript enabled to view it. </wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome1</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soapenv:Header>

SOAP 1.2 Protocol
<soapenv:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1">
<wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602">
<wsse:Username> This e-mail address is being protected from spambots. You need JavaScript enabled to view it. </wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome1</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soapenv:Header>
 

Integration User

To know the credentials of the integration user, you need to log in with your registered account, and then navigate to the People listing to find the user Id of the integration user. 
To generate a password for integration user, perform any of the following steps: 
  1. Select integration user row and click the generate password button on the left side toolbar.The App account holder will immediately receive a mail containing credentials of integration user.
  2. On the login page, click the forgot password link and by providing integration user id the App account holder will immediately receive a mail containing credentials of integration user.


Top


SwiftKanban Web Service exposes API to allow users to perform common card operations as listed below:

Project Service

MetadataService

ExtensionService

KanbanCardService

TeamMemberService
 
Top