平台接口规范-Http版本_V1.0.docVIP

国家中小企业信息化公共云服务平台 产品试用业务标准接口 文档名称 平台接口文档 文档类型 接口文档 作者 施铁钢 说明 本文档是平台对外业务产品试用接口文档 文件名称 平台接口规范_V1.0.docx 修订历史 版本 章节 类型 日期 作者 备注 1.0 所有 创建 -14 施铁钢 国家中小企业信息化公共云服务平台 内容范围： 本文档描述了平台提供合作伙伴接口的详细规范。 适用范围： 本文档接口适用于产品提供商与平台进行业务对接。 1 概述 １ 1.1 接口内容 １ 1.2 实现方式 １ 1.3 安全控制 １ 2 接口详细说明 ２ 2.1 数据格式说明 ２ 2.1.1 基本字段类型说明 ２ 2.1.2 加密密钥 ２ 2.1.3 产品提供商相应格式（需要向平台返回信息的时候用） ２ 2.2 接口说明 ３ 2.2.1 数据传递说明 ３ 2.3 附录： ４ 2.3.1 应答响应代码定义表 ４ 概述 国家中小企业公共服务平台系统接口规范是平台与产品提供商之间的协议规范，以实现产品提供商现有业务和平台的对接。云平台会按照协议中的规定向产品提供商传递相应的信息。 接口内容 主要提供1个方面的接口：用户信息接口。 实现方式 采用标准的Http post传输方式。 安全控制 系统采用如下的手段保证产品提供商平台的安全性： 加密密钥。 产品提供商验证判断后方可允许进入平台系统。 接口详细 数据格式说明 “字节数”栏目的解释： 各属性的“字节数”栏目给出的是最大字节数。实际接口报文中，字节数小于或等于此数值均视为为合法。 “必须”栏目的解释： Y：必须有符合条件的数值。 N：数值可以为空。 基本字段类型说明 类型 说明 Int 十进制的整数型 String 由char组成的字符串 加密密钥 名称 必须 类型 字节数 描述 isvkey Y string 50 密钥值（待定） 产品提供商相应格式（需要向平台返回信息的时候用） 应答内容格式为：srcreqno#respcode#respmsg 名称 必须 类型 字节数 描述 srcreqno Y String 18 请求的流水号, 格式为 YYYYMMDDHHmmssnnnn 对于不能获取nnnn 4位时间位的系统，采用3位毫秒+0补齐的方法，即nnn0。 respcode Y String 2 返回代码 respmsg N String 30 返回操作结果的信息详情 接口说明 数据传递说明 传递参数类型均为String类型. 用户基本信息 名称 必须 类型 字节数 描述 euid Y String 128 企业客户唯一标识 comName Y String 128 企业客户名称 loginID Y String 20 用户登录编号 loginName Y String 12 用户登录名 contactName Y String 32 企业联系人 position N String 32 职务 address N String 50 地址 mobile N String 50 手机 phone Y String 50 固定电话 email Y String 64 邮箱 postcode N String 6 邮编 加密格式 String str=”euid=”+euid+”loginName=”+loginName+” +”mobile=”+mobile+”phone=”+phone+”email=”+email+”postcode=”+postcode+”position=”+position+isvkey=”+isvkey; 平台传递给合作伙伴的信息 名称 必须 类型 字节数 描述 euid Y String 128 企业客户唯一标识 comName Y String 128 企业客户名称 loginID Y String 20 用户登录编号 loginName Y String 12 用户登录名 contactName Y String 32 企业联系人 position N String 32 职务 address N String 50 地址 mobile N String 50 手机 phone Y String 50 固定电话 email Y String 64 邮箱 postcode N String 6 邮编 mac Y String 512 加密后的数据 产品提供商得到 的信息后，根据的加密格式将信息加密，然后比照mac，若相同则允许进入系统，否则不允许。 附录： 应答响应代码定义表 respcode 信息内容 0 操作成功 1 参数错误 3 系统错误