开发者
在这里我们讲解短网址(dwz.nz)API的使用方法,因为一些开发者的需求对API进行了更改。
注册API密匙
和之前的一样,系统要求注册一个API密钥,当用户注册会员账号的时候,API密钥会自动生成。在进行API接口请求的时候,API密钥需要到URL参数中(请参见下面的完整的示例)。
发送一个生成短网址的请求
发送一个请求,用户必须使用下面的格式,api和url这两个参数是必需要有的。在下面的例子中,使用的是演示的URL,您需要替换成自己的域名。如果需要自定义别名,那么请在请求的最后面增加&custom=参数
GET http://dwz.nz/api?api=APIKEY&url=THELONGURLTOBESHORTENED&custom=CUSTOMALIAS
服务器响应
和之前一样,响应将以JSON格式编码(默认)返回,这样做是为了方便跨语言使用。响应的第一个元素是标识是否发生了错误(0-成功,1-出错),第二个元素会随着第一个元素的值的不同而改变,如果error的值为1,那么第二个元素为“msg”,内容是错误信息;如果error的值为0,那么第二个元素名称为“short”,内容是缩短了的URL(参考下面的例子):
// 成功
{ "error":0, "short":"http:\/\/dwz.nz\/DkZOb" } // 发生错误 { "error":1, "msg":"Please enter a valid email" }
使用纯文本格式
你可以在请求中最后面增加&format=text,来请求服务器以纯文本格式返回响应。这时会像http://dwz.nz/DkZOb返回,而不是JSON响应。注意:如果发生了错误,不会返回任何内容。
在PHP中使用API
在PHP程序中使用API,你可以通过file_get_contents或cURL来发送GET请求,下面是使用file_get_contents的例子:
<?php // 使用JSON响应 $api_url="http://dwz.nz/api?api=APIKEY&url=THELONGURLTOBESHORTENED&custom=CUSTOMALIAS"; $res= @json_decode(file_get_contents($api_url),TRUE); if($res["error"]){ echo $res["msg"]; }else{ echo $res["short"]; } // 使用纯文本响应 $api_url="http://dwz.nz/api?api=APIKEY&url=THELONGURLTOBESHORTENED&custom=CUSTOMALIAS&format=text"; $res= @file_get_contents($api_url); if($res){ echo $res; } ?>