本操作文档将指导您如何使用api方式来实现crmapi获取token,进一步查询数据和更新数据。通过此php文件,您可以快速了解crmapi的token获取相关内容。
1. Token获取
(1)修改示例中的getApiToken_new.php文件中的对应变量值:
$host_url:服务器地址;
$secretKey:crm中API接口授权码(API接口授权码可以通过“设置->系统设置->参数设置->系统参数设置->业务参数->API接口授权码”进行查看和修改);
$secret_text:自定义字符串(用于增加token复杂性,可为空或自定义固定获取随机字符串);
(2)直接执行该文件即可获取到对应的token和apikey值,这两个值在访问crmapi,查询或修改数据接口时使用
2. Token使用
(1)访问https://www.71mis.com/
(2)下载中心-开放api
(3)查询对应模块,单据查询接口、单据保存和更新接口的说明并使用。
注意:每次获取的token仅支持一次的访问,下次访问需要重新获取token
3. 安全性( 以下两个步骤开发者自行决定是否设置)
(1)Token回调校验,用于校验token来源的合法性
- 可在getApiToken_new.php中设置 $callback_data值(开发者可自行生成实时参数),该值为回调校验传输的参数data 使用的值。
- 可在config.inc.php里面设置$CRMAPIREVERSEVERIFICATION_URL的回调地址,该地址根据crm传入的参数data 校验,注意参数名称为:data.
- 回调地址返回值要求:json格式['code'=>'success','msg'=>''];仅code为为success时认为是校验成功,其他情况都为校验失败msg为提示信息;
(2) IP白名单
- 可在config.inc.php里面添加$CRMAPI_ALLOWED_IPS添加白名单的IP,这样可以严格控制访问来源。
白名单ip 是api_call.php 文件所在的服务器IP,例如:内网是:'192.168.1.5',外网是:“211.196.189.111”
$TEMPORARYTOKEN_ALLOWED_IPS = ['192.168.1.5','211.196.189.111']表示仅允许192.168.1.5和211.196.189.111访问)
php案例
java案例