智链远程函数手册

01两个函数是什么、怎么调

// 客户端调用示例（所有语言 SDK 相同，只是 api_type 不同）
// LUA 函数：api_type=35，参数 {"alias":"脚本别名","params":{业务参数}}
// 云函数　：api_type=18，参数 {"alias":"函数别名","params":{业务参数}}

02安全模型

脚本语言本体只有计算能力；一切外部能力（HTTP、Redis、KV、点数、封号）都来自下面列出的内置函数，且函数按别名维护、按用户限频。

03内置函数参考

以下函数在两个远程函数中均可使用，签名一致。标注 受控 的函数会修改服务器数据，请在后台确认后再启用对应脚本。

04完整示例

Lua（接口 35）—— 风控判定 + 业务放行

-- 脚本别名：check_risk
-- 逻辑：设备数超 3 台且 IP 归属地异常 → 拉黑；否则返回业务数据
local user = getUser()
local devices = getDevices()

-- 记录访问（KV 计数，按用户隔离）
local visits = kvIncr("visit_count", 1, "user")

-- Redis 防重放：同一用户 10 秒内重复请求直接拒绝
local lock = redisSetNX("req:" .. client_ip(), "1", 10)
if not lock then
    return {code = 429, msg = "请求过于频繁"}
end

-- 点数业务：每次调用扣 1 点（幂等标记防重复扣）
deductPoints(1, "check_risk-" .. nowMs())

return {
    visits = visits,
    devices = #devices,
    expires = user.expires
}

JavaScript（接口 18）—— 调第三方接口 + 数据加工

// 脚本别名：query_exchange
// 逻辑：调外部汇率接口，按用户点数折算
var resp = httpPost("https://api.example.com/rate", JSON.stringify({base: "CNY"}), {})
var rate = JSON.parse(resp).rate

var user = getUser()
return {
    points: user.points,
    usd_value: user.points * rate
}

05使用红线与建议

• 先用测试账号验证：banSelf / deductPoints / setData 会真实修改数据——写好脚本先用测试卡跑通再上生产。
• 扣点必须带 biz：deductPoints(n, biz) 的 biz 相同只扣一次，防止脚本重试导致重复扣费。
• 风控脚本加抖动：机械等间隔的调用模式会被时序指纹识别，脚本内不要写死循环轮询。
• 超时预算：Lua 10 秒 / goja 3 秒，httpGet / httpPost 计入超时——调慢接口的脚本注意预算。
• Redis 是缓存不是存储：未配置或过期会返回空，关键数据落 KV 或账号数据。
• 封停拉黑玩法：建一个文档不公开的脚本别名（如 debug_helper），命中即 addBlacklistSelf(0)——精准识别逆向者。