T/SAIA 016-2023 社区金融云平台大数据接口规范

范围:本文件规定了社区金融云平台大数据接口的术语和定义、符号和缩略语、接口分类、安全性要求、技术要求、数据模块API接口、应用场景API数据接口。 本文件适用于社区金融云平台大数据接口的设计、开发和应用; 主要技术内容:7 技术要求7.1 接口消息格式要求7.1.1 统一用户标识在社区金融云各个系统中对每个用户都有统一的对象ID标识，避免在各个系统中传输用户数据的时候产生混淆。本文件限定每个用户必须要有一个UUID来作为统一的用户标识。7.1.2 请求消息请求消息的组成包括：a）接口地址：调用接口请求的URL，在路径中应包含请求的资源名称。b）请求方法：应使用符合规范的GET、POST和PUT方法；c）请求头：可包含：——通过请求传递的附加信息，形式为键值对；——请求体提交数据的内容类型声明，如“Content-type:application/json”;——请求参数：包含一项或多项用于数据检索的参数，其中每一项由参数名与对应的参数值组成；应仅用于请求方法为GET方法的情况；——请求体：应包含提交的数据，宜仅用于请求方法为POST和PUT的情况。7.1.3 响应消息响应消息的组成包括：a）响应结果状态行；b）响应头：可包含：——通过响应传递的附加信息，形式为键值对；——请求体提交数据的内容类型声明，如“Content-type:application/json";c）响应体：应包括：——返回的数据；——优先考虑包含返回的数据所关联的存在性证明信息。7.2 接口数据证实7.2.1 客户身份数据采用GB/T 27912中的方法进行证实。7.2.2 数据提交认证数据提交检查处理结果为：a）经过认证的数据被接收。b）未经认证的数据被拒绝。7.2.3 接口通讯安全API接口通讯应符合：a)  通过SSL工具箱发起连接请求，检查是否得到正确的响应；b)  通过HTTP调用DLL发起连接与数据交换请求，检查是否得到正确的响应。7.2.4 接口消息格式检查请求消息，是否符合7.1.2，检查响应消息是否符合7.1.3