电销机器人开发引导

开发引导

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 签名，参数例如:

Content-Type : application/json
app-key : jjnloir454j6YRed5f4b2
datetime : Mon, 20 May 2019 12:28:18 GMT
sign : lod12j2AlHvd21h5b1f5f

编码：UTF-8