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 is not found mentioned here, feel free to contact us at support@swiftkanban.com 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 https://wso2.com/cloud/managed/security-policy/. 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

Location https://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>parth@gandiva.com</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>parth@gandiva.com</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

Integration User is one of the primary roles in Swiftkanban who can perform integration related activities for a particular account and Board. Any integration related activity needs to be performed through the integration user for better tracking. For example, if you want to add a card to the Board via web service, but don’t have access to the same Board, then you can do the same by using the credential of the Integration User. The card added will remain assigned the Integration User till it gets reassigned to someone else.
You are assigned one integration user license by default and can have any number of integration users for your SwiftKanban account depending on the assigned license. The password for the integration user is sent to the Account Admin. Moreover, any existing user can be modified to the integration user, but once done, can never be changed back to any other user role.

To find out 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 the 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.

  • Was this helpful?
  • Yes   No