《上云上平台接口规范v》由会员分享，可在线阅读，更多相关《上云上平台接口规范v（21页珍藏版）》请在金锄头文库上搜索。
1、. .上云上平台接口规版本修订批准记录【历次版本修订记录，版本修订描述重要说明】提交日期版本号版本修订描述修改人备注2021-2-250.9初稿锡均2021-03-071.0完善钊优选. -目录1 接口功能说明1.1 概述1.1.1 设计目的本规明确上云上平台与相关的供应商的接口协议，为开发人员在进展接口设计、开发、使用过程中提供指导性意见。1.1.2 加密协议使用rsa 和 aes 相结合的方法加密接口返回数据，上云上平台通过请求头方式将公钥告知各个供应商接口，各个供应商接口返回数据时，需要通过aes算法对返回数据进展加密，同时也需要利用公钥，对aes密钥进展加密处理返回。相关代码见附录1.
2、1.3 编码格式统一是用UTF-81.2 接口功能说明1.2.1 使用说明用户id、操作开场时间、操作完毕时间，获取对应用户操作数据信息1.2.2 请求1.2.2.1.1 请求参数统一请求头参数名称说明数据类型可空Content-Type固定数据类型 application/json; charset=UTF-8StringNRSAPublicKeyRsa 公钥StringNdata参数名称说明数据类型可空userId系统用户id ，可以多个，以逗号分割StringNbeginTime操作时间开场yyyyMMddHHmmsslongNendTime操作时间完毕yyyyMMddHHmmsslon
3、gY1.2.2.1.2 请求的json文档格式例如1.2.2.1.3 请求的平安问题建议对固定ip做白处理(14.116.209.154, 122.13.1.153, 113.108.192.70)1.2.2.2 返回1.2.2.2.1 返回参数参数名称说明数据类型可空respCode0：成功，其它：失败。StringNrespMsg返回值详细说明StringNdataCryptoData实体keyString加密的Aes密钥，NcontentString加密的返回数据加密时请注意将返回结果转为json字符串再做加密ObjectN1.2.2.2.1.1 data参数名称说明数据类型可空comp
4、anyId企业id，上云上平台和效劳商统一StringYcompanyName企业名称StringYuserId用户id，企业自己填报的userId，泛指能够确定用户唯一的数据，如用户编码，等StringNconnectMethod方式，1物联网卡，2-手机app，3-以太网longNmechineId设备id，物联网卡中的设备号String如果方式是物联网卡，必填，其他类型，可以为空source源地址，物联网卡中指卡号手机app中指手机号以太网中指源ipNtarget目标，目标ip或域名NreqDuring请求时长，效劳端收到请求到返回数据的间隔时间，单位：毫秒，没有就不传，不做要求Ycon
5、tLen请求的文本的长度，效劳端返回的数据的长度，单位，kb，没有就不传，不做要求YoperateTime发生时间，格式yyyyMMddHHmmsslongN1.2.2.2.2 返回json文档格式例如 respCode: 0, respMsg: SUCCESS, data: key: bBw8sRM+zDqk7yJOAd0MmeckqoJveVQSlP6vcK0fs54vrDVmZdDpuu7VugW+JvjiP9pDEb/cUBYFjkwgXOFFkQ=, content: mk6xF16WxJAKwVBI5d7ULGmpajGuPEa59SRibZrGYrQ4gDmcir7/BKmWms
6、Ft82VCnWAPItQz3nQRnnGDCSJ9tMxRBdkpXH76OwD7mKPV+s+alfaA+tuUtYSM/omTFHdc8kjxA6V+sFK5rDDtbV6amT+5nJwWYtlqtMHCL34L1m6hE+agF5nTDvgaqhJzKkNwy2BecybxIeFo6f1LJXySv46q3ZvUmIBhwceTlnnWoWisBPAAbjR/rwhJv0oEc4nNKWRILOD83RQSs9YqV3noqd0Aq2UTm0lWIbBFO2tW0Wm9yC1Unfnb2e6MRdkLOK2FApp6Fk4+YEXK6NwmdrvhZEN7I7+mfM+kWEF45j
7、W1vhzJUI3JqjaMZ2oLacl3shfnM79LQSjrJZqxHxzlMcCxd3HMgZlIe6Cw3JgEajsRmzs4Ni0nVg+uFgQUsJPufUq0mnWOAsH4mZoPnadC030Q2gssRv7vSF6PG75WrnGzYdGlpOselJHlBWVfwrGP3jS4K7pp/Jczk/K6p54QRjKbsNQqInSCzpC8dBcQxZRB42KlwMiy7OKkek7Sslbc20LlANvaSFAkO481Az4g6KLlzkAtSrmCL3perrYDAHne6B0/6YiZ+nuq0GHkeKmDG9mfEDqU/wWZUAMGC+NG6T
8、3uWp5wnT5fezuifKjNqaXRHWtbxjTeApmnLd8AQG1aTiHlURxwbOV3pnVrwrPiaNEsY332CMSqHoU6lMNzp8LELEseqkS3TjEYFtFOMfCVJ91Bnhycsr7TPhsU/fx1DIc+PLkUBsODCBi8WEaHK6FB4zciemmVgJ4bWl+icq52D226eDZ7A+xFRKWranHQFcKpK0hf1Ak8K6K3s4H3buDQmNpS5bS2SozSetPJRixImw6w/9Y3OLHR/cIlAzzUB6372YDbs4nr5t/ipTAYIhGjWj58GjCFwd+Jtjn1FwGXVp
9、YSADJdrWZS0ZkRRRWjAjB2BVKeQ14CeLhJFjEcyQ7n3MR+gfMw/1iQ6fhOya/yC1uMvkihg9VlkohHjRliA8qdKkQTaVr1kXEE+/LiBK5NnbL6Z+/FDFpHnzJCm5WWihkh7XEGCUoTvpHIdxa0bQp9FXTkdVSdd/6fm6J3ukL3PJ3YMO/U/kDxza8euc4EJ1R77naiSGXWuZ/Xfge7kCrYxeU3Sg/A4VVkbxmqj8V2FjMeYH9vJtBNUPbg2vuP0dSOt0G1yj0ffLHcGunaCmd1zK75knQBWNseQNhGwDdU9L
10、EGKqrDfUPfGk50XnzxWAwLPF5B6p4jaba03jXt/W8z1Dkao+0nNJZP9PLaxc469zEE3rEU1jPxQYsSTolKeovrJgPeWAcCsfGj/1zb59RcBl1aWEgAyXa1mUtGZEUUnVowIwdgVSnkNeAni4SRYxHMkO9zEfoHzMP9YkOn4Tsmv8gtbjL5IoYPVZZKIR40ZYgPKnSpEE2lan9ZFxBPvy4gSuTZ2y+mfvxQxaR8yQpuVlooZIe1xBglKE76RyHfdxKg6j9SgDxtctDJ3CF3WAf1Y/nlQ+2mIdQeL0nOCoQhTq
11、Uw3OnwsQsSx6qRLdOMRgW0U4x8JUn3UGHJyyvtM+GxT9/HUMhz48uRQGwn4MIGLxYRocroUHjNyJ6aZWAnhtaX6JyrnYPbbp4NnsD7EVEpatodAVwqkrSF/UCTwrorezgfdu4NnCY2lLltLZKjNJy4DUKMFnUB2qfSfHP9t3QHNlTmgzbaRZLhPV0Z42TFVlMBgiEaNaPnwaMIXB34mn2OfUXAZdWlhIAMl2tZlLRmRFFFaMCMHYFUp5DXgJ4uEkWMRzJDvcxH6B8zD/WJDp+E7Jr/ILW4y+nSKGD1WWSiEe
12、NGWIDyp0qRBNpWvWRcQT78uIErk2dsvpn78UMWkfMkKblZaKGSHtcQYJShO+kch1GnTimAO9fg+QVKyms7Qinxne6Qvc8ndgw79T+QPHNrx65zgQnVHvtqJIZda5n9d+B7uQKtjF5TdKD8nDhVWRvGadehqX5rQZzBabMqdvoj13aMx6Njwun9YWNmdIRn4MhNoKZ3XMrvmSdAFY2x5A2EbAN1Tn0sQYqqsN9Q98aTnRefPFYDAs8XkHqniNptrTeNfto1iNmRj6RlT4X4FckOIVzjr3MQTesRTWM/FBnixJ
13、OiUp6i+smA95YBwKx8aP/XNvn1FwGXVpYSADJdrWZS0ZkRRRWjAjB2BVKeQ14CeLhJOQbqI5vnDpJPHwoKuoM15ZhOya/yC1uMvkihg9VlkohHjRliA8qdKkQTaVr1kXEE+/LiBK5NnbL6Z+/FDFpHnzJCm5WWihkh7XEGCUoTvpHIdDZeILbBYCtKA0pMHdn6jE53ukL3PJ3YMO/U/kDxza8euc4EJ1R77naiSGXWuZ/Xfge7kCrYxeU3Sg/A4VVkbxmqj8V2FjMeYH9vJtBNUPbg2vuP0dSOt0G1yj0ffL
14、HcGunaCmd1zK75knQBWNseQNhGwDdU9LEGKqrDfUPfGk50XnzxWAwLPF5B6p4jaba03jXoQqpOTlzXv2Fnq9OwvudRgpQw6yYkJMVj5fQtTt3FYpcJxzQ78GOda5apPt/TVpO/QJ8AuDg7kbFCqqhYzqeHmZ2OnjTcmL+w+9zLP/m8X6W9nYMpkEsz8POz5CfiCv7q19m0WtNuxYwOX4Impf3wTp+zRt3uRDt1lwBGcnmYlooPTP09YPnr/Uo/6dvxSpmxjz1VI7jCxThiazCyvKXvcAoyUjB04oVanBFyBHhEeAIkompyYAnuWSVDVNsZtkrSMeernOBCdUe+2okhl1rmf134Hu5Aq2MXlN0oPwOFVZG8Zp16GpfmtBnMFpsyp2+niPXdozHo2PC6f1hY2Z0hGfgyE2gpndcyu+ZJ0AVjbHkDYRsA3VPSxBiqqw31D3xpOdF588VgMCzxneQeqeI2m2tN412v6yOzeePwD/qHF8rMW3kDOOvcxBN6xFNYz8UGLEk6JSnqL6
