API概述与加密流程
Hi客服是一款集成在网页端的JS代码,兼容PC、H5、APP、小程序等主流应用,能够结合API的调用,让客户方便的与客服人员发起会话,是企业获客、售后服务的好帮手。
Hi客服的特点是能够显示客户在自己网站注册的身份id,方便企业有效沟通,便于售后管理与维护。
API主要运用了MD5加密把客户的身份信息通过一系列加密方式传送给本站服务器,用于验证身份是否真实,对于企业这边就需要配合Hi客服把客户的id、昵称、头像等信息加密后传送给本站,利用的是php、.net、asp、jsp等网页后台语言代码计算得出的结果。
加密流程说明
加密流程sdk里都已集成,如果您的应用语言本站已有对应sdk,请直接下载sdk
名称 | 类型 | 必填 | 说明 |
sid | string | 是 | Hi客服服务的sid 查询 |
id | string | 是 | 客户在自己网站上的id,支持字母数字邮箱,如为访客请设空白字符串 |
nick | string | 是 | 客户昵称,需使用URLEncode UTF-8进行编码,编码后还需替换"+"为"%20",可设空白字符串。 |
face | string | 是 | 客户头像URL,需使用URLEncode UTF-8进行编码,编码后还需替换"+"为"%20",可设空白字符串。 |
date | string | 是 | 当前日期格式为24时双字符制,中间分隔必须为“-”。如:2008-08-08 |
key | string | 是 | Hi客服服务的密钥key 查询 |
(以下为php代码)把上述参数通过字符串拼接方式利用md5算法计算结果,获得token。
复制$token = md5("sid=" . $sid . "&id=" . $id . "&nick=" . str_replace("+","%20",urlencode($nick)) . "&face=" . str_replace("+","%20",urlencode($face)) . "&date=" . $date . "&key=" . $key);
(以下为JS代码)仅用以表示加密流程,并非流程可以写到js代码里,这样您的key会泄露,切记!!
复制var token = $.md5("sid=" + sid + "&id=" + id + "&nick=" + encodeURIComponent(nick).replaceAll("+","%20") + "&face=" + encodeURIComponent(face).replaceAll("+","%20") + "&date=" + date + "&key=" + key);
您还可以进行 加密在线调试