灵活网络服务

灵活网络服务允许IB客户通过HTTPS协议进入预配置的灵活查询，不用登录到账户管理。此特点使得客户能够用其偏好的语言写出自动化的客户软件，从而能够实时地请求先前定义的灵活账单查询。

目前有两种版本灵活网络服务可用：第二版及第三版。第三版可供您指定使用的版本并回复更多有意义的错误信息。对两个版本的描述列出如下。

1. 启用灵活网络服务

要对一个账户启用灵活网络服务，登录到账户管理并在报告管理菜单下点击被标记为“灵活网络服务”的链接。点击此链接将对账户启用灵活网络服务。

在获得确认号码前，检查服务状态是否为有效是很重要的。如果状态被设为暂停，只需点击链接来重新激活。

2. 获得确认号码

您将在确认灵活网络服务已被批准的相同屏幕上收到确认号码。此确认号码将被用于：

1. 启动灵活查询，以及
2. 检索灵活报告

确认号码被默认为6小时有效，在此时间之后您必须通过账户管理获得一个新确认号码。您有机会选择增将灵活确认号码有效的时间范围。确认号码也能够被附在特定的IP地址上以获得更高的安全性。

3. 启动自动的灵活网络服务请求

要启动灵活自动请求您将需要以下信息：

1. 初始URL: https://www.interactivebrokers.com/Universal/servlet/FlexStatementService.SendRequest
2. 确认号码：在上面获得。
3. 灵活查询号码：号码在创建灵活查询时产生。

注: 编制程序访问需要设置User-Agent HTTP标题。可接受的值是：Blackberry 或 Java.

第二版查询格式

https://www.interactivebrokers.com/Universal/servlet/FlexStatementService.SendRequest?t=TOKEN&q=QUERY_ID&v=2

此处：
TOKEN = 您已经获得的确认号码
QUERY_ID = 您创建灵活查询时生成的灵活查询ID
v=2指明您使用的是灵活网络服务第二版。请注意如果您不指定版本，系统将使用第二版。

第二版XML回复

您将从IB收到XML回复，包括下列信息：

• 参考编码 - 如果要求成功，XML回复将包含一个数字参考编码。该编码可用于获取生成的灵活查询。
  如果要求不成功，您收到的编码将是错误信息。
• 回复URL - 用于获取灵活报告的URL。

第二版XML回复举例

如果成功：

如果发生错误：

第三版查询格式

https://www.interactivebrokers.com/Universal/servlet/FlexStatementService.SendRequest?t=TOKEN&q=QUERY_ID&v=3

此处：
TOKEN = 您已经获取的确认号码
QUERY_ID = 您创建灵活查询时生成的灵活查询ID
v=3指明您使用的是灵活网络服务第三版。请注意如果您不指定版本，系统将使用第二版。

第三版XML回复

您将从IB收到XML回复，包括下列信息：

• 状态 - 如果要求成功，状态将为Success。如果要求失败，状态将为Fail。
• 参考代码- 如果要求成功，XML回复将包含一个数字参考编码。该编码可用于获取生成的灵活查询。
  
• 回复URL - 用于获取灵活报告的URL。

第三版举例 - 成功XML回复

如果要求不成功，回复将包含下列参数：

• Fail
• XXXX
  此处XXXX = 数字错误编码。
• TEXT
  此处TEXT是对错误的文本描述。

第三版举例 - 失败的XML回复

检索灵活报告

检索灵活数据，您将需要以下信息:

• 回应URL: 这个URL是当您下达查询时收到的回应的一部分。
• 参考编码: 这个编码是当您下达查询时收到的回应的一部分。
• 确认号码: 这将是同用于起始灵活查询相同的验证号码。
• 版本：设置为2或3。

注：如果您提交要求获取报表时报表仍在生成，请勿重新启动灵活要求，而请不断尝试获取报表。

查询格式

https://www.interactivebrokers.com/Universal/servlet/FlexStatementService.GetStatement?q=REFERENCE_CODE&t=TOKEN
&v=VERSION

此处：
REFERENCE_CODE = 您在提出要求时收到的回复的一部分。
TOKEN = 您已经获取的确认号码
VERSION = 2或3，指明您使用的灵活网络服务版本。请注意如果您不指定版本，系统将使用第二版。

如果查询成功，您收到的回应将为灵活数据。否则，您将收到基于XML的回应，告知您查询无效。

要求不成功时XML回复第二版举例

要求不成功时XML回复第三版举例

错误编码

下面的表格中列出了错误编码和错误信息参数回复的所有错误编码和错误描述。