开发者

在这里我们讲解短网址（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;
  }
?>