API标准

safe.mn, clic.gs, go2.gs, cliks.fr和888.hn的API是相同的

API不断发展,我们作出更多的功能提供给第三方.

PHP, Perl, Python, Javascript等文件库的列表见文件库.

压缩网址

输入网址

跟踪一个短链接

压缩网址

要求

要压缩长网址,以这种方式发出GET请求::

http://safe.mn/api/shorten?url=<url>&format=<format>&callback=<callback>

有下面的价值 <...>:

参数必需的含意可能的值系统默认值评论
url必需的长网址http://www.reviews-web-hosting.com/none 
alias自选的简短的别名EXAMPLEnone别名必须包含5至100个字符(字母,数字,_, 和- ).
format自选的回复的形式xml (XML), json (Json), jsonp (JsonP) or text (plain text)text 
callback自选的JsonP 的回调函数safemn_resultmissing_callback只可在格式=jsonp时使用

我们建议您不要依赖于默认值。你应该明确指定格式和回调(JsonP)。

回复

XML:

圆满成功:

<?xml version="1.0" encoding="UTF-8" ?>
<data>
 <url>http://safe.mn/c</url>
</data>

错误:

<?xml version="1.0" encoding="UTF-8" ?>
<data>
 <error>Invalid URL</error>
</data>

Json:

圆满成功:

{ "url": "http://safe.mn/c" }

错误:

{ "error": "Invalid URL" }

JsonP (callback=safe123):

圆满成功:

safe123({ "url": "http://safe.mn/c" })

错误:

safe123({ "error": "Invalid URL" })

纯文本:

圆满成功:

http://safe.mn/c

错误:

Error: Invalid URL

注:在服务器答复中可能会有额外的空格(制表符,空格,换行)

范例

要求:

http://safe.mn/api/shorten?url=http://www.aol.net/&format=jsonp&callback=safe123

回复:

safe123({ "url": "http://safe.mn/c" })

要求:

http://safe.mn/api/shorten?url=http://www.aol.net/&alias=AOL-NET&format=json

回复:

{ "url": "http://safe.mn/AOL-NET" }

顶部

输入网址

要求

要获得短网址的长网址,以这种方式发出GET请求:

http://safe.mn/api/expand?short_url=<url>&format=<format>&callback=<callback>

有下面的价值 <...>:

参数必需的含意可能的值系统默认值评论
short_url必需的压缩 网址http://safe.mn/1none 
format自选的回复的形式xml (XML), json (Json), jsonp (JsonP) or text (plain text)text 
callback自选的JsonP 的回调函数safemn_resultmissing_callback只可在格式=jsonp时使用

我们建议您不要依赖于默认值。你应该明确指定格式和回调(JsonP)。

回复

XML:

圆满成功:

<?xml version="1.0" encoding="UTF-8" ?>
<data>
 <url>http://www.google.com/</url>
</data>

错误:

<?xml version="1.0" encoding="UTF-8" ?>
<data>
 <error>Invalid URL</error>
</data>

Json:

圆满成功:

{ "url": "http://www.google.com/" }

错误:

{ "error": "Invalid URL" }

JsonP (callback=safe123):

圆满成功:

safe123({ "url": "http://www.google.com/" })

错误:

safe123({ "error": "Invalid URL" })

纯文本:

圆满成功:

http://www.google.com/

错误:

Error: Invalid URL

注:在服务器答复中可能会有额外的空格(制表符,空格,换行)

范例

要求:

http://safe.mn/api/expand?short_url=http://safe.mn/c&format=xml

回复:

<?xml version='1.0' ?>
<data>
 <url>http://www.aol.net/</url>
</data>

顶部

跟踪一个短链接

要求

要压缩长网址,以这种方式发出GET请求::

http://safe.mn/api/info?url=<url>&format=<format>&callback=<callback>

有下面的价值 <...>:

参数必需的含意可能的值系统默认值评论
url必需的长网址http://www.reviews-web-hosting.com/none 
format自选的回复的形式xml (XML), json (Json), jsonp (JsonP) or text (plain text)text 
callback自选的JsonP 的回调函数safemn_resultmissing_callback只可在格式=jsonp时使用

我们建议您不要依赖于默认值。你应该明确指定格式和回调(JsonP)。

回复

json

参数含意可能的值评论
url长网址http://www.reviews-web-hosting.com/ 
clicks短链接的点击次数1201Integer
referers每个原域名的点击次数[["Direct Access/Applications","1,151"],["baidu.com","2"]]阵列偶 [Domain, Clicks]
countries每个国家的点击次数[["United States","851"],["China","94"]]阵列偶 [Country, Clicks]
filetype潜在危险文件类型application/x-dosexecEmpty if safe
virus病毒名Eicar-Test-Signature如果没有病毒是空值
dangerous已确认的危险网站Spyware/Malware/Adware如果安全为空
partial部分下载10. 下载完成
unreachable网页无法访问10. 网页可登陆
activex危险ActiveX名称00000000-0000-0000-0000-000000000000 CnBabe Adware如果安全为空
xss跨站脚本攻击10. 网址安全
categoryContent categoryAdult如果安全为空
redirection太多重定向10. 没有太多网址回调
error错误发生Invalid URL如果成功就没有错误列表
qr_shortQR码的网址短链接http://safe.m/static/images/qr/1-safe.gif 
qr_longQR码的网址长链接http://safe.mn/static/images/qr/1.gif 

jsonp

Same as json.

xml

Root名称: <data>

参数含意可能的值评论
url长网址<url>http://www.reviews-web-hosting.com/</url> 
clicks短链接的点击次数<clicks>1201</clicks>Integer
referers每个原域名的点击次数<referers>
  <referer clicks="1151" domain="Direct Access/Applications" />
  <referer clicks="2" domain="baidu.com" />
</referers>
List of <referer clicks="Clicks" domain="Domain" />
countries每个国家的点击次数<countries>
  <country name="United States" clicks="851" />
  <country name="China" clicks="94" />
<countries>
List of <country name="Country" clicks="Clicks" />
filetype潜在危险文件类型<filetype>application/x-dosexec</filetype>Empty if safe
virus病毒名<virus>Eicar-Test-Signature</virus>如果没有病毒是空值
dangerous已确认的危险网站<dangerous>Spyware/Malware/Adware</dangerous>如果安全为空
partial部分下载<partial>1</partial>0. 下载完成
unreachable网页无法访问<unreachable>1</unreachable>0. 网页可登陆
activex危险ActiveX名称<activex>00000000-0000-0000-0000-000000000000 CnBabe Adware</activex>如果安全为空
xss跨站脚本攻击<xss>1</xss>0. 网址安全
categoryContent category<category>Adult</category>如果安全为空
redirection太多重定向<redirection>1</redirection>0. 没有太多网址回调
error错误发生<error>Invalid URL</error>如果成功就没有错误列表
qr_shortQR码的网址短链接<qr_short>http://safe.m/static/images/qr/1-safe.gif</qr_short> 
qr_longQR码的网址长链接<qr_long>http://safe.mn/static/images/qr/1.gif</qr_long> 

text

字段之间用一个换行符 \n.

参数含意可能的值评论
url长网址url: http://www.reviews-web-hosting.com/ 
clicks短链接的点击次数clicks: 1201Integer
referers每个原域名的点击次数referers: "Direct Access/Applications": 1151 "baidu.com": 2 
countries每个国家的点击次数countries: "United States": 851 "China": 94 
filetype潜在危险文件类型filetype: application/x-dosexecEmpty if safe
virus病毒名virus: Eicar-Test-Signature如果没有病毒是空值
dangerous已确认的危险网站dangerous: Spyware/Malware/Adware如果安全为空
partial部分下载partial: 10. 下载完成
unreachable网页无法访问unreachable: 10. 网页可登陆
activex危险ActiveX名称activex: 00000000-0000-0000-0000-000000000000 CnBabe Adware如果安全为空
xss跨站脚本攻击xss: 10. 网址安全
categoryContent categorycategory: Adult如果安全为空
redirection太多重定向redirection: 10. 没有太多网址回调
error错误发生error: Invalid URL如果成功就没有错误列表
qr_shortQR码的网址短链接http://safe.m/static/images/qr/1-safe.gif 
qr_longQR码的网址长链接http://safe.mn/static/images/qr/1.gif 

范例

圆满成功:

http://safe.mn/api/info?url=http://safe.mn/1&format=xml
<?xml version='1.0' ?>
<data>
 <activex></activex>
 <category></category>
 <clicks>1246</clicks>
 <countries>
 <country name="United States" clicks="851" />
 <country name="China" clicks="94" />
 <country name="Romania" clicks="53" />
 <country name="Russian Federation" clicks="46" />
 <country name="Japan" clicks="32" />
 <country name="Germany" clicks="24" />
 <country name="Taiwan" clicks="23" />
 <country name="Netherlands" clicks="20" />
[...]
 </countries>
 <download></download>
 <filetype></filetype>
 <google></google>
 <redirection></redirection>
 <referers>
 <referer clicks="1151" domain="Direct Access/Applications" />
 <referer clicks="73" domain="safe.mn" />
 <referer clicks="2" domain="192.168.1.75" />
 <referer clicks="2" domain="win.mail.ru" />
 <referer clicks="2" domain="baidu.com" />
 <referer clicks="1" domain="znatok.biz" />
 <referer clicks="1" domain="digifur.com" />
 <referer clicks="1" domain="www.ipark.cn" />
[...]
 </referers>
 <unreachable>0</unreachable>
 <url>http://www.amazon.com/gp/product/1430224258/ref=s9_intb_gw_i1?pf_rd_m=ATVPDKIKX0DER
&pf_rd_s=center-2&pf_rd_r=10DQS8RKGF8F4G84WJBD&pf_rd_t=101&pf_rd_p=470938631
&pf_rd_i=507846</url>
 <virus></virus>
 <xss></xss>
 <qr_short>http://safe.mn/static/images/qr/1-safe.gif</qr_short>
 <qr_long>http://safe.mn/static/images/qr/1.gif</qr_long>
</data>

错误:

http://go2.gs/api/info?url=foo&format=json
{"error":"Invalid URL"}

顶部