本文介绍了金蝶云Web API对接的基本概念,主要包括登录接口和单据操作接口,以及API对接的三个准备工作:URL、请求参数和Cookies。特别说明了登录接口的URL和请求参数,并提供了Python代码示例实现登录。文末提供了QQ群号供同行交流学习,并预告了后续其他接口对接的分享链接。
在我的个人理解中,API对接的本质是模拟用户手工操作,通过代码自动完成的一个方式。因此,跟用户操作一样,金碟云的Web API主要分为登录,单据操作(保存,提交,审核,反审核,下推,作废,关闭,修改,更新,查看等等)。
由于各个接口分享的内容加起来较多,所以我划成了多个页面进行分享,具体分享链接请关注评论内容。本页面分享关于登录接口对接的心得,其他接口对接的分享链接,请关注评论内容,里面有链接。
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 另外,如果大家有遇到问题,随时可以加我建立的QQ群:712623210 (金蝶云Web API系统集成沟通群)。只要我能解决的,都会帮忙,毕竟大家都是一个行业的,相互交流,学习。----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
对接的3个准备工作(适用于金蝶云的所有Web API)
1:URL(即链接):
登录接口的URL是:https://自己企业的登录域名 + /k3cloud/Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser.common.kdsvc(固定不变)举个例子,如果贵公司的登录域名是:https://thisisatest.ik3cloud.com,那么,登录接口的URL就应该是:https://thisisatest.ik3cloud.com/k3cloud/Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser.common.kdsvc顺便说明一下,我上面举例是用https协议的,而有的企业是http协议的,如果是的话,就要使用http协议。尽量复制域名,这样才不会出错,也别多复制一个k3cloud哈。
2: Data(即请求参数):
打开金蝶的Web API功能,可以看到登录接口的请求参数有,如图所示如上图,有四个请求参数:A:acctID:帐套Id,字符串类型(必录)B:username:用户名称,字符串类型(必录)C:password:用户密码,字符串类型(必录)D:lcid:语言标识,数值类型(中文简体:2052)闲话不多说,解释说明请看下面截图,你就能明白了。
3:Cookies(用户验证,基于HTTP协议的)
特别说明一下,登录时是不需要携带Cookies提交的。而对单据进行操作时,就需要携带Cookise的。
另外金蝶云的所有API都是采用POST方式提交的,所以需要用到requests模块(要带s的,不是request)里面的post方法,这一点必须记住。
把这3个准备好,基本就搞定了,闲话不多说,直接上Python代码:
import requests
login_url="https://pocknoiral.ik3cloud.com/k3cloud/Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser.common.kdsvc"
login_data={"acctid":"20180321174312","username":"你的用户名","password":"你的","lcid":2052}
response=requests.post(url=login_url,data=login_data)
print(response.text)
返回信息:{"Message":null,"MessageCode":"CheckPasswordPolicy","LoginResultType":1}LoginResultType==1,说明登录成功了!!!-----------------------------------------------------------------------------------------------------------------------------------------------------------
后续其他对接分享心得,请关注评论内容,里面有链接。
非常感谢!!!!!
推荐阅读