平台概述

开发者协议

API调用约定

接入指南

认证授权

返回结果

API详情

系统API

业务网关API

业务API详情

账务平台登录接口

常见问题

安全保障

获取业务类API的server_url

/Kisoemapi/get_server_url

请求地址url

正式：http://kd.cmcloud.cn/Kisoemapi/get_server_url

测试：http://kd.cmcloud.cn:8080/Kisoemapi/get_server_url

请求方式

Get/Post

认证方式

由开发者申请的 client_id 、client_secret 认证

调用限制

调用频率限制 每天调用次数限制

请求参数

参数名称参数类型是否必填参数说明
EIDstring是企业号
Timestampstring是时间戳，格式为yyyy-mm-dd HH:mm:ss，例如：2014-03-14 16:52:03，KD API服务端允许客户端请求时间误差为3分钟，需要urlencode，Get方式需要urlencode
ClientIDstring是开发者ID，即申请成为开发者分配的client_id
Signstring是签名串，值为md5(Timestamp + EID + ClientID + ClientSecret + State )，其中加号“+”为字符串连接符，ClientSecret就是申请成为开发者分配的client_secret
Statestring是请求端的状态值（由长度大于等于16位大小写字母和数字组成，要求每次的随机数不能重复，必须唯一），重定向后会带上state参数，开发者可以填写a-zA-Z0-9的参数值，最多128字节

格式：

http://[server_url]/Kisoemapi/get_server_url?
EID=xxx&Sign=xxxx&Timestamp=2014-03-14+11%3A44%3A44&State=xxxxxxx&ClientID =xxxx

返回结果

参数名称参数类型参数说明
Resultint返回码：200 正常，大于200 异常
Msgstring如果Result不为200，会有相应的错误信息提示，UTF-8编码 ，比如：403 非法请求,200 获取成功,201 获取失败，失败原因
Dataarray如果Result为200 返回Data，若Data有多个值，显示产品名称，第三方系统需要弹出界面供用户选择其中一个产品；若Data仅有一个值，第三方系统不需弹出选择界面，系统自动选择，然后供业务类API路由接口 /Webapi/router使用

Data参数格式

参数名称参数类型参数说明
NetIDstring网络ID，若不存在网络ID，会直接返回企业号
ProductNamestring产品名称（仅用于多个产品实例时，供客户选择需要）
ServerUrlstring业务类API的server_url
AppSecretstring业务类API的应用数据（CustData）加密密钥

返回格式：

{ 

     "Result":200,
     "Msg":"success",
     "Data":[
               {"NetID":"","ProductName":"" ,"ServerUrl":"192.168.1.120","AppSecret":""}，
               {"NetID":"","ProductName":"" ,"ServerUrl":"192.168.1.120", "AppSecret":""},
               ......
            ]

}