一麦云盾开放API文档
一、概述
一麦 (YIMAI)云盾开放平台API 是一麦短网址为第三方开发人员提供的编程接口。您可以利用此 API 查询某个URL
的属性。目前一麦短网址云安全API支持的功能包括:查询一个URL是否是钓鱼、欺诈、色情等网站。该技术为一麦云
盾自有技术，比目前一些门户的相关开发接口还要先进，可以测试验证。
二、恶意网址查询API说明
功能：查询一个网址是否属于钓鱼/欺诈性质URL：http://yimai.cc/api/safeurl.php
返回值格式：json
HTTP请求方式：POST
请求参数: q
返回值查询成功返回值：{“status”: 0}
查询失败返回值：{“status”: 1, “error”: $error,}
status=0说明查询成功，如果status>0,说明查询失败，$error为错误提示字符串。
三、示例：(PHP版)
使用一麦云盾查询 haobi365.com 是否是恶意网址.代码如下：
$ch=curl_init();
curl_setopt($ch,CURLOPT_URL,”http://yimai.cc/api/safeurl.php”);
curl_setopt($ch,CURLOPT_POST,true);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
$data=array(‘q’=>’haobi365.com’);
curl_setopt($ch,CURLOPT_POSTFIELDS,$data);
$strRes=curl_exec($ch);
curl_close($ch);
echo $strRes;
访问此URL返回值为:{“status”:1,”error”:”URLu5df2u88abu8bb0u5f55
u5728u4e00u9ea6u4e91u7aefu6076u610fu7f51u5740u5e93uff0c
u5982u6709u7591u4e49u8bf7u8054u7cfbu7ba1u7406u5458″}
因为返回的status>0,说明 haobi365.com 是恶意网址
四、一些开发建议
1、短网址站点使用该接口的时候，建议在转发的时候做判断，而不是缩短的时候。因为恶意网址库是会不断增加
的。如果你缩短的时候判断，就会导致很多漏网之鱼；而转发的时候判断，漏网之鱼几乎不可能，因为每次转发都
会判断一次，随库更新而更新。
2、待补充
怎样调用一麦短网址API？
生成短网址
请求：向yimai.cc/api/create.php发送post请求，发送数据包括url=长网址
返回：json格式的数据
status!=0 出错，查看err_msg获得错误信息（UTF-8编码）
成功，返回生成的短网址tinyurl字段
自定义短网址
请求：向yimai.cc/api/create.php发送post请求，发送数据包括url=长网址&alias=自定义网址
返回：json格式的数据
status!=0 出错，查看err_msg获得错误信息（UTF-8编码）
成功，返回生成的短网址tinyurl字段
显示原网址
请求：向yimai.cc/query.php发送post请求，发送数据包括tinyurl=查询的短地址
返回：json格式的数据
status!=0 出错，查看err_msg获得错误信息（UTF-8编码）
成功，返回原网址 longurl字段
示例程序：
生成短网址
$ch=curl_init();
curl_setopt($ch,CURLOPT_URL,”http://yimai.cc/api/create.php”);
curl_setopt($ch,CURLOPT_POST,true);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
$data=array(‘url’=>’http://www.quhuanxing.com’);
curl_setopt($ch,CURLOPT_POSTFIELDS,$data);
$strRes=curl_exec($ch);
curl_close($ch);
$arrResponse=json_decode($strRes,true);
if($arrResponse[‘status’]!=0)
{
/**错误处理*/
echo $arrResponse[‘err_msg’];
}else{
/** tinyurl */
echo $arrResponse[‘tinyurl’].”n”;
}
其他接口使用如上
一麦短网址API使用说明 怎样调用一麦短网址API？
生成短网址
请求：向yimai.cc/api/create.php发送post请求，发送数据包括url=长网址
返回：json格式的数据
status!=0 出错，查看err_msg获得错误信息（UTF-8编码）
成功，返回生成的短网址tinyurl字段
自定义短网址
请求：向yimai.cc/api/create.php发送post请求，发送数据包括url=长网址&alias=自定义网址
返回：json格式的数据
status!=0 出错，查看err_msg获得错误信息（UTF-8编码）
成功，返回生成的短网址tinyurl字段
显示原网址
请求：向yimai.cc/query.php发送post请求，发送数据包括tinyurl=查询的短地址
返回：json格式的数据
status!=0 出错，查看err_msg获得错误信息（UTF-8编码）
成功，返回原网址 longurl字段
示例程序：
生成短网址
$ch=curl_init();
curl_setopt($ch,CURLOPT_URL,”http://yimai.cc/api/create.php”);
curl_setopt($ch,CURLOPT_POST,true);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
$data=array(‘url’=>’http://www.quhuanxing.com’);
curl_setopt($ch,CURLOPT_POSTFIELDS,$data);
$strRes=curl_exec($ch);
curl_close($ch);
$arrResponse=json_decode($strRes,true);
if($arrResponse[‘status’]!=0)
{
/**错误处理*/
echo $arrResponse[‘err_msg’];
}else{
/** tinyurl */
echo $arrResponse[‘tinyurl’].”n”;
}
其他接口使用如上