电销机器人开发引导-巨人通讯

开发引导

1.认证

为确保您的账户和信息安全，请在开发对接程序前支持接口调用专属密钥。

您必须替换对接密钥 APP KEY 和 APP SECRET在您的对接程序中，密钥可在 http://ai.zxycall.com 平台登录后，在个人信息页面中获取 app key 和 app secret。

API认证采用HMACSha1加密算法进行加密，使用 app secret、app key 和GMT时间戳共同生成一个sign签名，在每次调用请带上如下参数或将参数添加到请求头中：

PHP 生成签名算法：

/**
* 签名
* 规则：appKey + "\n" + GMT时间
* GMT格式： Mon, 20 May 2019 12:28:18 GMT
* date("D, d M Y H:i:s e")
*
* @param String $appKey
* @param String $appSecret
* @param String $date 时间：Thu, 13 Dec 2018 01:27:17 GMT
* @return string
*/
private static function generateSign (String $appKey, String $appSecret,String $date)
{
if (function_exists('hash_hmac')) {
$stringToSign = $appKey . "\n" . $date;
return base64_encode(hash_hmac("sha1", $stringToSign, $appSecret, true));
}
}

JAVA 生成签名算法：下载

2.统一请求格式

请求域名

http://ai.zxycall.com

URL格式：

/{version}/{resource}/{function}

{version}为版本号

{resource}为资源名，通常对应一类API

{function}为该资源提供的操作方法

请求响应的结果为json格式

HTTP头信息:

需要在每次调用的时候在您的Headers里面带上生成的 app-key ,datetime 以及由上面生成的 sign 签名，参数例如:

编码：UTF-8