已归档 短网址API文档

[NingYin]

什么是短网址？
短网址服务可以帮助你把一个长网址缩短，方便你在社交网络和微博上分享链接。
例如，你可以把这样一个长网址
http://www.mgmcpe.cc/ 成这样一个短网址

http://4mg.top/ZTA1MT

相对于长网址，短网址可以更方便地在电子邮件、社交网络、微博和手机上传播，避免折行或超出字符限制。

怎样生成一个短网址？
我们提供多种方式使用我们的短网址服务：

• 访问短网址首页http://4mg.top，输入你要缩短的原网址，生成对应的短网址。你还可以自定义你想要的短网址字符
• 使用短网址API开发的各种应用，调用短网址服务。例如书签、桌面程序、小插件等。

怎样分享一个短网址？
短网址给分享传播链接带来很大的便利。在生成一个短网址后，你可以：

• 点击“分享到：”后面的图标，可以把你的短网址分享到常见的社交网络
• 点击右边的复制链接按钮，然后粘贴到你要分享的地方

怎样还原一个短网址？
当你看到一个已生成的短网址，想知道原来的网址是什么，怎样还原呢？
在短网址的“还原网址”页面输入你要还原的短网址，点击“还原”按钮，就可以看到对应的原始网址

怎样调用短网址API？
生成短网址
请求：向4mg.top/create.php发送post请求，发送数据包括url=长网址
返回：json格式的数据
success=false 出错，查看message获得错误信息（UTF-8编码）
成功，返回生成的短网址 tinyurl字段
自定义短网址请求：向4mg.top/create.php发送post请求，发送数据包括url=长网址&alias=自定义网址
返回：json格式的数据
success=false 出错，查看message获得错误信息（UTF-8编码）
成功，返回生成的短网址 tinyurl字段
显示原网址
请求：向4mg.top/query.php发送post请求，发送数据包括tinyurl=查询的短地址
返回：json格式的数据
success=false 出错，查看message获得错误信息（UTF-8编码）
成功，返回原网址 longurl字段

示例程序：

<?php
$ch=curl_init();
curl_setopt($ch,CURLOPT_URL,"http://4mg.top/create.php");
curl_setopt($ch,CURLOPT_POST,true);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
$data=array('url'=>'http://www.mgmcpe.cc/');
curl_setopt($ch,CURLOPT_POSTFIELDS,$data);
$strRes=curl_exec($ch);
curl_close($ch);
$arrResponse=json_decode($strRes,true);
if($arrResponse['success']==0)
{
/**错误处理*/
echo $arrResponse['message']."\n";
}
/** tinyurl */
echo $arrResponse['tinyurl']."\n";
?>