playbook/skills/tsl-api-reference/references/codegen/module/ts-opi.md

第三方交互 / TS-OPI

tsgetsessionname()

声明：function

返回当前租户名称；适用于同一函数可能由不同租户调用的场景

返回：string

tsgetapiname()

声明：function

返回当前 API 用户名

返回：string

tenantCall(session_key, call_name, param, timeout)

声明：function

调用已创建租户公开的接口，不需要取得租户接口的具体实现

参数	类型	说明
session_key	string	租户的 SESSION-KEY；租户设置密码时使用 SESSION-KEY:PWD 形式
call_name	string	租户公开的调用名称；空字符串表示使用默认调用
param	array	传给租户接口的参数数组
timeout	integer	可选。调用超时时间，单位为毫秒

返回：any

示例

范例01：使用掩码租户 SESSION-KEY 调用接口；需已为该租户配置调用权限

session_key := "{58DC***DF58}";
return tenantCall(
    session_key,
    "HQData",
    array("StockID": "SZ000002")
);

opsCall(call_name, ops_name, param, timeout)

声明：function

调用 TS-OPS 服务上的函数，并返回可取得最终结果的网格结果对象

参数	类型	说明
call_name	string	OPS 服务提供的函数名称
ops_name	string	注册时由 TS-OPS-ID 定义的服务名；空字符串表示使用支持该函数的默认 OPS 服务
param	array	传给 OPS 函数的参数数组
timeout	integer	可选。调用超时时间，单位为毫秒

返回：grid_result

示例

范例01：调用已启动的 OPS 服务；需对应服务已注册并保持运行

return opsCall(
    "hahaha",
    "OPSName1",
    array(10, 3),
    5000
);

td_opi_getHQData01(stock_id, endt, cy)

声明：function

获取指定证券、日期和周期的价格与成交量数据

参数	类型	说明
stock_id	string|array	证券代码或证券代码集合
endt	t_date	计算或查询使用的日期时间边界
cy	string	行情或统计周期

返回：array

示例

范例01：TSL 开发用户调用

url := "https://opi.tinysoft.com.cn/Service/Call/TD_opi_getHQData01";
header := "Connection: keep-alive\r\nContent-Type: application/json\r\nTS-EVENTNAME: auto\r\nJSON-Encode: gbk";
arguments := array("StockID": "SZ000002");
session := createHttpSession();
post_data := exportJsonString(arguments);
ok := internetRequest(
    session,
    url,
    "",
    header,
    post_data,
    "tuser",
    "tpassw",
    0,
    result,
    response_code,
    30000
);
echo "ok:", ok, " response_code:", response_code, " result:", result, "\r\n";
destroyHttpSession(session);

范例02：Python 开发用户调用

import requests
from requests.auth import HTTPBasicAuth

url = "https://opi.tinysoft.com.cn/Service/Call/TD_opi_getHQData01"
headers = {
    "Connection": "keep-alive",
    "Content-Type": "application/json",
    "TS-EVENTNAME": "auto",
    "JSON-Encode": "gbk",
}


post_data = {"StockID": "SZ000002"}
session = requests.Session()
session.auth = HTTPBasicAuth("tuser", "tpassw")
session.headers.update(headers)
response = session.post(url, json=post_data)
print(response.status_code)
print(response.text)
response.close()

范例03：MATLAB 开发用户调用

url = 'https://opi.tinysoft.com.cn/Service/Call/TD_opi_getHQData01';
data.StockID = ["SZ000002", "SH000300"];
options = weboptions();
options.RequestMethod = 'post';
options.Username = 'tuser';
options.Password = 'tpassw';
options.MediaType = 'application/json';
response = webwrite(url, data, options);
disp(response);

范例04：R 开发用户调用

library(httr)

url <- "https://opi.tinysoft.com.cn/Service/Call/TD_opi_getHQData01"
headers <- c(
    "Connection" = "keep-alive",
    "Content-Type" = "application/json",
    "TS-EVENTNAME" = "auto",
    "JSON-Encode" = "gbk"
)
post_data <- list(StockID = "SZ000002")
response <- POST(
    url = url,
    body = post_data,
    encode = "json",
    add_headers(.headers = headers),
    authenticate("tuser", "tpassw", type = "basic")
)
cat(status_code(response), "\n")
cat(content(response, "text", encoding = "gbk"), "\n")

范例05：JavaScript 开发用户调用

var xhr = new XMLHttpRequest();
var url = "https://opi.tinysoft.com.cn/Service/Call/TD_opi_getHQData01";
var data = JSON.stringify({StockID: ["SZ000002", "SH000300"]});
xhr.open("POST", url, true);
xhr.setRequestHeader("Content-type", "application/json");
xhr.setRequestHeader("username", "tuser");
xhr.setRequestHeader("password", "tpassw");
xhr.onreadystatechange = function () {
    if (xhr.readyState == 4 && xhr.status == 200) {
        console.log(xhr.responseText);
    }
};
xhr.send(data);

范例06：TSL Session-Key 租户调用

session_key := "{58DC***DF58}";
url := "https://opi.tinysoft.com.cn/Service/Session/Call/HQData";
arguments := array("StockID": "SZ000002");
header := "Connection: keep-alive\r\nContent-Type: application/json\r\nAuthorization: Bearer " $ session_key $ "\r\nTS-EVENTNAME: auto\r\nJSON-Encode: gbk";
session := createHttpSession();
post_data := exportJsonString(arguments);
ok := internetRequest(
    session,
    url,
    "",
    header,
    post_data,
    "",
    "",
    0,
    result,
    response_code,
    30000
);
echo "ok:", ok, " response_code:", response_code, " result:", result, "\r\n";
destroyHttpSession(session);

范例07：Python Session-Key 租户调用

from datetime import datetime, timedelta
import requests

TSL_EPOCH = datetime(1899, 12, 30)

def py_date_to_tsl(value: datetime) -> float:
    return (value - TSL_EPOCH) / timedelta(days=1)

session_key = "{58DC***DF58}"
url = "https://opi.tinysoft.com.cn/Service/Session/Call/HQData"
headers = {
    "Connection": "keep-alive",
    "Content-Type": "application/json",
    "Authorization": f"Bearer {session_key}",
    "TS-EVENTNAME": "auto",
    "JSON-Encode": "gbk",
}
post_data = ["SZ000002", py_date_to_tsl(datetime(2026, 3, 25)), "日线"]
response = requests.post(url, headers=headers, json=post_data)
print(response.status_code)
print(response.text)
response.close()

范例08：OPS 服务函数实现

echo hahaha(1000, 9999);

function hahaha(a = 1000, b = 200);
begin
    if ifNumber(a) and ifNumber(b) then
    begin
        return a * b;
    end
    else
    begin
        importFile(ftXls(), "", "C:\test\testwbdata.xlsx", data);
        return data;
    end
end;

范例09：TSL 调用 OPS 服务函数

url := "https://opi.tinysoft.com.cn/Service/Call/OPS/hahaha";
header := "Connection: keep-alive\r\nContent-Type: application/json\r\nJSON-Encode: gbk\r\nTS-EVENTNAME: wbdata";
ok := internetRequest(
    url,
    "",
    header,
    '{"a":1000,"b":9999}',
    "tuser",
    "tpassw",
    0,
    result,
    response_code,
    500000
);
echo "ok:", ok, " response_code:", response_code, " result:", result, "\r\n";

范例10：Python 调用 OPS 服务函数

import requests
from requests.auth import HTTPBasicAuth

url = "https://opi.tinysoft.com.cn/Service/Call/OPS/hahaha"
headers = {
    "Connection": "keep-alive",
    "Content-Type": "application/json",
    "TS-EVENTNAME": "wbdata",
    "JSON-Encode": "gbk",
}
session = requests.Session()
session.auth = HTTPBasicAuth("tuser", "tpassw")
session.headers.update(headers)
response = session.post(url, json={"a": 1000, "b": 9999})
print(response.status_code)
print(response.text)
response.close()

范例11：TSL 订阅 OPS SSE 数据

url := "https://opi.tinysoft.com.cn/Service/OPS/Subscription/time";
header := "Connection: keep-alive\r\nContent-Type: application/json\r\nJSON-Encode: gbk\r\nTS-EVENTNAME: wbdata\r\nAccept: text/event-stream";
session := createHttpSession();
setHttpMode(session, 1);
while true do
begin
    ok := internetRequest(
        session,
        url,
        "",
        header,
        "{}",
        "tuser",
        "tpassw",
        0,
        result,
        response_code,
        500000
    );
    echo "ok:", ok, " response_code:", response_code, " result:", result, "\r\n";
end;

范例12：Python 订阅 OPS SSE 数据

import json
import requests

url = "https://opi.tinysoft.com.cn/Service/OPS/Subscription/time"
headers = {
    "Accept": "text/event-stream",
    "Connection": "keep-alive",
    "Content-Type": "application/json",
    "JSON-Encode": "gbk",
    "TS-EVENTNAME": "wbdata",
}
response = requests.post(
    url,
    headers=headers,
    data="{}",
    auth=("tuser", "tpassw"),
    stream=True,
    timeout=30,
)
for line in response.iter_lines(decode_unicode=True):
    if line and line.startswith("data:"):
        print(json.loads(line[5:].strip()))

范例13：JavaScript 与 TSL 日期互转

function tslDateToJs(tslDate) {
    const daysFromTslEpochToUnixEpoch = 25569.0;
    const daysSinceUnixEpoch = tslDate - daysFromTslEpochToUnixEpoch;
    const millisecondsSinceUnixEpoch = daysSinceUnixEpoch * 24 * 60 * 60 * 1000;
    return new Date(millisecondsSinceUnixEpoch);
}

function jsDateToTsl(jsDate) {
    const millisecondsSinceUnixEpoch = jsDate.getTime();
    const daysSinceUnixEpoch = millisecondsSinceUnixEpoch / (24 * 60 * 60 * 1000);
    return daysSinceUnixEpoch + 25569.0;
}

范例14：Python 与 TSL 日期互转

from datetime import datetime, timedelta

TSL_EPOCH = datetime(1899, 12, 30)

def tsl_date_to_py(value: float) -> datetime:
    return TSL_EPOCH + timedelta(days=value)

def py_date_to_tsl(value: datetime) -> float:
    return (value - TSL_EPOCH) / timedelta(days=1)