Site.ApiType的历史版本

隐藏细微更改 - 以实际显示效果显示

2016年-04月-12日127.0.0.1 -
改为:
!/Kisoemapi/get_server_url
(获取业务类API的server_url)
更新为以下内容:
!获取业务类API的server_url
!!/Kisoemapi/get_server_url
2016年-04月-12日127.0.0.1 -
在第 33 增加以下内容:
在第 41 增加以下内容:
改为:
返回格式:
更新为以下内容:

!!返回格式:

改为:
"Result":200,
"Msg":"success",
“Data”:[
{“NetID”:””,”ProductName”:”” ,”ServerUrl”:”192.168.1.120”,” AppSecret”
:””},
{“NetID”:””,”ProductName”:”” ,”ServerUrl”:”192.168.1.120”, “AppSecret”
:””},
……
]
更新为以下内容:
     "Result":200,
     "Msg":"success",
     "Data":[
               {"NetID":"","ProductName":"" ,"ServerUrl":"192.168.1.120","AppSecret":""},
              {"NetID":"","ProductName":"" ,"ServerUrl":"192.168.1.120", "AppSecret":""},
              ......
           
]
在 62-65 行中增加以下内容:



2016年-04月-12日127.0.0.1 -
改为:
 http://[server_url]/Kisoemapi/get_server_url?EID=xxx&Sign=xxxx&Timestamp=2014-03-14+11%3A44%3A44&State=xxxxxxx&ClientID =xxxx
更新为以下内容:

|| class=pre
||
http://[server_url]/Kisoemapi/get_server_url?\\
EID=xxx&Sign=xxxx&Timestamp=2014-03-14+11%3A44%3A44&State=xxxxxxx&ClientID =xxxx||
2016年-04月-12日127.0.0.1 -
将 20 行由:
||!参数名称 ||!参数类型||!是否必填||参数说明||
更新为以下内容:
||!参数名称 ||!参数类型||!是否必填||!参数说明||
改为:
||[[account-phone-vcode|发送手机验证码]] ||POST ||passport/account/phone/vcode||
||[[account
-phone-post|注册手机账号]]||POST ||passport/account/phone||
||[[account-phone-put|手机找回密码]]||PUT||passport/account/phone||
||[[account-email-post|注册邮箱账号]]||POST ||passport/account/email||
||[[account-email-put|邮箱找回密码]] ||PUT||passport/account/email||
||[[user
-get|获取用户基本信息]]||GET||passport/user||
||[[user-org-
get|获取用户的组织]] ||GET||passport/user/org||
||[[user-org-post|为用户创建组织]] ||POST ||passport/user/org||
||[[user-group-get|获取用户的团队]] ||GET||passport/user/org||
||[[user
-group-post|为用户创建团队]] ||POST ||passport/user/org||
||[[org-get|获取组织信息]] ||GET||passport/org||
||[[org-post|修改组织信息]] ||PUT||passport/org||
||[[org-member-get|获取组织成员信息]] ||GET||passport/org/member||
||[[org-member-post|添加组织成员]] ||POST||passport/org/member||
||[[org-member-del|移除组织成员]] ||DELETE||passport/org/member||
||
[[org-admin-post|添加组织管理员]] ||POST||passport/org/admin||
||[[org-admin-del|删除组织管理员]] ||DELETE||passport/org/admin||
||[[group-get|获取团队信息]] ||GET||passport/group||
||[[group-put|修改团队信息]] ||PUT||passport/group||
更新为以下内容:
||Timestamp||string ||||时间戳,格式为yyyy-mm-dd HH:mm:ss,例如:2014-03-14 16:52:03,KD API服务端允许客户端请求时间误差为3分钟,需要urlencode,Get方式需要urlencode
||ClientID||string ||||开发者ID,即申请成为开发者分配的client_id
||Sign||string ||||签名串,值为md5(Timestamp + EID + ClientID + ClientSecret + State ),其中加号“+”为字符串连接符,ClientSecret就是申请成为开发者分配的client_secret
||State||string ||||请求端的状态值(由长度大于等于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

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

!!Data参数格式
|| class=table-of-content
||!参数名称 ||!参数类型||!参数说明||
||NetID||string||网络ID,若不存在网络ID,会直接返回企业号
||ProductName||string||产品名称(仅用于多个产品实例时,供客户选择需要)
||ServerUrl||string||业务类API的server_url
||AppSecret||string||业务类API的应用数据(CustData)加密密钥

返回格式:
{
"Result":200,
"Msg":"success",
“Data”:
[
{“NetID”:””,”ProductName”:”” ,”ServerUrl”:”192.168.1.120”,” AppSecret”:””},
{“NetID”:””,”ProductName”:”” ,”ServerUrl”:”192.168.1.120”, “AppSecret”:””},
……
]
}
2016年-04月-12日127.0.0.1 -
在第 5 增加以下内容:
2016年-04月-12日127.0.0.1 -
在 1-39 行中增加以下内容:
!/Kisoemapi/get_server_url
(获取业务类API的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 认证

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

!!请求参数
|| class=table-of-content
||!参数名称 ||!参数类型||!是否必填||参数说明||
||EID ||string ||是||企业号
||[[account-phone-vcode|发送手机验证码]] ||POST ||passport/account/phone/vcode||
||[[account-phone-post|注册手机账号]]||POST ||passport/account/phone||
||[[account-phone-put|手机找回密码]]||PUT||passport/account/phone||
||[[account-email-post|注册邮箱账号]]||POST ||passport/account/email||
||[[account-email-put|邮箱找回密码]] ||PUT||passport/account/email||
||[[user-get|获取用户基本信息]]||GET||passport/user||
||[[user-org-get|获取用户的组织]] ||GET||passport/user/org||
||[[user-org-post|为用户创建组织]] ||POST ||passport/user/org||
||[[user-group-get|获取用户的团队]] ||GET||passport/user/org||
||[[user-group-post|为用户创建团队]] ||POST ||passport/user/org||
||[[org-get|获取组织信息]] ||GET||passport/org||
||[[org-post|修改组织信息]] ||PUT||passport/org||
||[[org-member-get|获取组织成员信息]] ||GET||passport/org/member||
||[[org-member-post|添加组织成员]] ||POST||passport/org/member||
||[[org-member-del|移除组织成员]] ||DELETE||passport/org/member||
||[[org-admin-post|添加组织管理员]] ||POST||passport/org/admin||
||[[org-admin-del|删除组织管理员]] ||DELETE||passport/org/admin||
||[[group-get|获取团队信息]] ||GET||passport/group||
||[[group-put|修改团队信息]] ||PUT||passport/group||