2008-11-10 135 views
6

我正在构建一些自定义工具来处理JIRA安装,并且公开的SOAP API非常棒,除了没有任何参数被命名。JIRA SOAP API文档?

例如,原型getIssue是:

RemoteIssue getIssue (string in0, string in1); 

所有SOAP RPC方法遵守这个约定,所以没有证件我敢hardpressed搞清楚什么来传递这些很多。

有谁知道最权威的API文档指南?

+0

我使用API​​来见http://confluence.atlassian.com/display/JIRA/JIRA+RPC+Services搜索可能的方法名称,然后阅读源代码以查看实际预期的内容。 – mdoar 2012-01-16 17:35:57

回答

15
+1

我必须有点不熟练,但我不完全满意这个文档。我几乎与你的配置相同,我想使用createIssue方法。 为此,我创建了一个RemoteIssue对象的实例,并设置了以下参数:类型,摘要,项目,受托人,描述和优先级,它们都是字符串。 但我必须为类型设置什么值? RemoteIssueType.name? RemoteIssueType.id?以及总结,项目等? 我在哪里可以找到关于此的精确文档?感谢您的帮助 – PierrOz 2009-07-07 09:21:27

2

你发现的Javadoc链接是正确的。您还应该知道,并非所有内容都通过SOAP或RPC接口公开,但您可以使用REST接口完成任何操作。不幸的是,REST界面没有很好的文档记录,但是您可以使用HTML流量检测器工具(如IE的Fiddler)来抓取从Web界面发送到服务器的实际POST数据,并将特定调用的接口需要。并不总是最简单的方法,但它确实有效。

3

我发现这很简单,直观的参数应该是。根据你要进行的复杂程度,你可能会猜到你应该通过什么。

有虽然一个超级重要的(这是用Python SOAPpy的):

self.proxy = WSDL.Proxy(jiraUrl) 
self.token = self.proxy.login(self.username, self.password) 
... 
issues = self.proxy.getIssuesFromFilter(self.token, args[0]) 

从login()方法获得令牌后,您需要在把它作为参数传递给所有其他的SOAP调用。搞清楚了这一点后,它已经相当简单的计算出的参数应该是什么(例如,getIssuesFromFilter应采取filterId为其他参数)