当前接口状态 · 正常

云端函数,有效防破解

  • API文档
  • 错误码参照
  • 示例代码

接口地址: https://yz.jilicun.com/api.php?api=cloudfunctions

备用接口: https://yz1.jilicun.com/api.php?api=cloudfunctions

海外接口: https://www.ban365.com/api.php?api=cloudfunctions

返回格式: JSON

请求方式: GET

请求示例: https://yz.jilicun.com/api.php?api=cloudfunctions&app=10000 复制示例 跳转示例

请求参数说明:

名称 变量 必填 类型 说明
接口 api GET 填写cloudfunctions
应用 app GET 填写后台应用APPID
卡密 kami GET/POST/JSON 填写提交的卡密
设备码 markcode GET/POST/JSON 如果开启了[验证设备]需提交此项
云函数ID function_id GET/POST/JSON 填写要执行的云函数ID
输入参数 input POST/JSON 传入云函数的输入参数,推荐传JSON对象;若传字符串JSON会自动解码
时间戳 t GET/POST/JSON 如果开启了[时间差效验]需提交此项
数据签名 sign GET/POST/JSON 如果开启了[数据签名]需提交此项

返回参数说明:

名称 类型 说明
code Number 接口状态码,200表示执行成功
msg.success Boolean 云函数业务执行是否成功,由云函数return结果决定
msg.data Object/Array/String/Number/Boolean/Null 云函数返回的业务数据,对应云函数return对象里的data
msg.message String 云函数返回的说明文本,对应云函数return对象里的message
time Number 接口响应时间戳
check String 接口校验串

返回示例:

{
  "code": 200,
  "msg": {
    "success": true,
    "data": {
      "加法": 15,
      "减法": 5,
      "乘法": 50,
      "除法": 2,
      "平方和": 125
    },
    "message": "ok"
  },
  "time": 1782794657,
  "check": "6b287730d7d7ce9db232a3ae17411192"
}

函数关闭时示例:
{
  "code": 211,
  "msg": {
    "success": false,
    "data": null,
    "message": "该云函数已关闭"
  },
  "time": 1782794657,
  "check": "6b287730d7d7ce9db232a3ae17411192"
}

错误码格式说明:

名称 类型 说明
101 String 应用不存在
102 String 应用已关闭
171 String 接口维护中
172 String 接口未添加或不存在
104 String 签名为空
105 String 数据过期
106 String 签名有误
148 String 卡密为空
149 String 卡密不存在
151 String 卡密禁用
165 String 时间戳缺失、无效或超出允许范围
169 String IP不一致
201 String 卡密已到期或业务校验失败
211 String/Object 函数ID无效、input不是有效JSON、函数不存在不可用,或函数已关闭;关闭时返回:msg.success=false,msg.data=null,msg.message=该云函数已关闭

代码示例:

请求示例:
POST /api/?api=cloudfunctions&app=10001
Content-Type: application/json

{
  "kami": "test_kami",
  "markcode": "device_001",
  "function_id": 20,
  "input": {
    "a": 10,
    "b": 5
  },
  "t": 1782794657
}

云函数示例:
const a = Number(input.a || 0);
const b = Number(input.b || 0);

const results = {
  加法: a + b,
  减法: a - b,
  乘法: a * b,
  除法: b === 0 ? null : a / b,
  平方和: a * a + b * b
};

return {
  success: true,
  data: results,
  message: 'ok'
};

点我进群