开发者

在这里我们讲解短网址(dwz.nz)API的使用方法,因为一些开发者的需求对API进行了更改。

注册API密匙

和之前的一样,系统要求注册一个API密钥,当用户注册会员账号的时候,API密钥会自动生成。在进行API接口请求的时候,API密钥需要到URL参数中(请参见下面的完整的示例)。

发送一个生成短网址的请求

发送一个请求,用户必须使用下面的格式,apiurl这两个参数是必需要有的。在下面的例子中,使用的是演示的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_contentscURL来发送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;
  }
?>