开发引导
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