我正在构建一些自定义工具来处理 JIRA 安装,并且公开的 SOAP API 很棒,除了没有命名任何参数。
例如,getIssue 的原型是:
RemoteIssue getIssue (string in0, string in1);
所有的 SOAP RPC 方法都遵循这个约定,所以如果没有文档,我很难弄清楚要传递很多这些方法。
有人知道权威的 API 文档指南吗?
我正在构建一些自定义工具来处理 JIRA 安装,并且公开的 SOAP API 很棒,除了没有命名任何参数。
例如,getIssue 的原型是:
RemoteIssue getIssue (string in0, string in1);
所有的 SOAP RPC 方法都遵循这个约定,所以如果没有文档,我很难弄清楚要传递很多这些方法。
有人知道权威的 API 文档指南吗?
我发现直觉参数应该是什么非常简单。根据你的复杂程度,你可能会猜到你应该通过什么。
不过有一个非常重要的(这是带有 SOAPpy 的 Python):
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 作为它的另一个参数)
有关所有 JIRA RPC 服务,请参阅http://confluence.atlassian.com/display/JIRA/JIRA+RPC+Services
您找到的 javadoc 链接是正确的。您还应该知道,并非所有内容都通过 SOAP 或 RPC 接口公开,但您可以使用 REST 接口执行任何操作。不幸的是,REST 接口没有很好的文档记录,但是您可以使用 HTML 流量检查器工具(如 IE 的 Fiddler)来获取从 Web 界面发送到服务器的实际 POST 数据,并将特定呼叫的接口拼凑在一起需要。并不总是最简单的方法,但它确实有效。