更新时间:2023-11-17 GMT+08:00
开发规范
API调用认证开发要求
- 开发工具版本要求:
- IntelliJ IDEA:2018.3.5或以上版本。
- Eclipse:3.6.0或以上版本。
- Visual Studio:2019 version 16.8.4或以上版本。
- 开发语言环境版本要求:
- Java:1.8.111或以上版本的Java Development Kit。
- Go:1.14及以上版本的Go安装包。
- Python:2.7或3.X版本的Python安装包。
- JavaScript:15.10.0及以上版本的Nodejs安装包。
- PHP:8.0.3及以上版本的PHP安装包。
- Android:4.1.2及以上版本的Android Studio。
- 浏览器版本要求:Chrome 89.0或以上版本。
- SDK签名限制:
- 使用SDK对API请求签名时,仅支持对Body体为12M及以下的请求进行签名。
- 发送API请求时,SDK会将当前时间置于HTTP的X-Sdk-Date头,将签名信息置于Authorization头。签名只在一个有限的时间内是有效的,超时即无效。
- ROMA Connect除了校验X-Sdk-Date的时间格式外,还会校验该时间值与收到请求的时间差,如果时间差超过15分钟,ROMA Connect将拒绝请求。因此,客户端须注意本地与NTP服务器的时间同步,避免请求消息头X-Sdk-Date的值出现较大误差。
自定义后端开发要求
- 函数后端开发要求:
- 仅支持使用JavaScript编写函数,JavaScript的运行采用Java Nashorn的运行标准,支持ECMAScript Edition 5.1规范。
- 函数后端支持的脚本大小最大为32KB。
- 数据后端开发要求:
- 若数据后端执行语句查询获取的数据量较大,建议携带offset和limit参数进行分页,避免因响应数据太大导致响应超时。使用方式如下:
select * from table01 limit '${limit}' offset ${offset}
其中offset和limit参数key在后端服务请求的Headers、Parameters或Body中传递。
- 不建议开启结果分页选项,结果分页当前仅支持2000条以内数据的分页。
- 数据后端支持的执行语句大小最大为32KB。
- 若数据后端执行语句查询获取的数据量较大,建议携带offset和limit参数进行分页,避免因响应数据太大导致响应超时。使用方式如下:
后端服务签名校验开发要求
- 开发工具版本要求:
- IntelliJ IDEA:2018.3.5或以上版本。
- Eclipse:3.6.0或以上版本。
- Visual Studio:2019 version 16.8.4或以上版本。
- 开发语言环境版本要求:
- Java:1.8.111或以上版本的Java Development Kit。
- Python:2.7或3.X版本的Python安装包。
- SDK使用限制:
- Java SDK仅支持hmac和basic类型的后端服务签名。
- Python SDK仅支持hmac类型的后端服务签名。
- C# SDK仅支持hmac类型的后端服务签名。
父主题: 开发说明