開發(fā)引導(dǎo)
1.認證
為確保您的賬戶 和信息安全，請在開發(fā)對接程序前支持接口調(diào)用專屬密鑰。
您必須替換對接密鑰 APP KEY 和 APP SECRET在您的對接程序中，密鑰可在 http://ai.zxycall.com 平臺登錄后，在個人信息頁面中獲取 app key 和 app secret。
API認證采用HMACSha1加密算法進行加密，使用 app secret、app key 和GMT時間戳共同生成一個sign簽名，在每次調(diào)用請帶上如下參數(shù)或?qū)?shù)添加到請求頭中：
PHP 生成簽名算法：
-
/**
-
* 簽名
-
* 規(guī)則：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.統(tǒng)一請求格式
請求域名
http://ai.zxycall.com
URL格式：
/{version}/{resource}/{function}
{version}為版本號
{resource}為資源名，通常對應(yīng)一類API
{function}為該資源提供的操作方法
請求響應(yīng)的結(jié)果為json格式
HTTP頭信息:
需要在每次調(diào)用的時候在您的Headers里面帶上生成的 app-key ,datetime 以及由上面生成的 sign 簽名，參數(shù)例如:
-
Content-Type : application/json
-
app-key : jjnloir454j6YRed5f4b2
-
datetime : Mon, 20 May 2019 12:28:18 GMT
-
sign : lod12j2AlHvd21h5b1f5f
編碼：UTF-8
