API接口

PHP中的API使用

C34.CN短网址服务快速、稳定、永久有效,免费开放短网址API接口,基于txt/json/jsonp模式,支持批量缩短网址,适配所有设备,目前没有对请求数做任何限制,无广告、无二次跳转,请勿滥用!

发送请求需要API key,用户注册账户后,将自动生成API key,必须通过key参数随每个请求发送API key(请参阅下面的完整示例),如果API key未发送或过期,则会出现错误,请务必保密您的API key以防止滥用。


发送缩短网址请求

要发送请求,用户必须使用以下格式,其中需要变量api和url,要请求自定义短网址,只需在末尾添加(&custom=自定义别名)即可。

GET http://c34.cn/api/?key=API key&url=要缩短的网址&custom=自定义别名(可选)

服务器响应

使用text格式(默认)

返回纯文本txt格式,请注意,如果发生错误,不会输出任何内容,因此您可以判断它是否为空,否则会出现错误。

示例
http://c34.cn/api/?key=API key&url=要缩短的网址

使用json格式

在请求结尾添加&format=json,响应将以JSON格式编码,这样做是为了便于跨语言使用,响应的第一个参数”error“表示是否发生了错误1或0,第二个参数将相对于第一个元素发生变化,如果有错误,则第二个参数将命名为“msg”,其中包含错误原因,否则将命名为“short”,其中包含短URL(见下面的例子)。

示例
http://c34.cn/api/?key=API key&url=要缩短的网址&format=json

没有错误

{"error":0,"short":"http:\/\/c34.cn\/DkZOb"}

发生错误

{"error":1,"msg":"Please enter a valid url" }

使用jsonp格式

如需API返回jsonp格式,在请求结尾添加&format=jsonp来请求返回jsonp格式,callback为可选自定义参数。

示例
http://c34.cn/api/?key=API key&url=要缩短的网址&format=jsonp&callback=callbackname
callbackname({"error":0,"short":"http:\/\/c34.cn\/DkZOb"})

在PHP中使用API

要在PHP程序中使用API,您必须通过file_get_contents或cURL发送GET请求:两者都是可靠的方法,您可以直接复制下面的代码。

<?php/**** Sample PHP Function ***/function shorten($url, $custom = "", $format = "json") { $api_url = "http://c34.cn/api/?key=API key";$api_url .= "&url=".urlencode(filter_var($url, FILTER_SANITIZE_URL));if(!empty($custom)){$api_url .= "&custom=".strip_tags($custom);}$curl = curl_init();curl_setopt_array($curl, array(CURLOPT_RETURNTRANSFER => 1,CURLOPT_SSL_VERIFYPEER => false,CURLOPT_SSL_VERIFYHOST => false,CURLOPT_URL => $api_url));$Response = curl_exec($curl);curl_close($curl);if($format == "text"){$Ar = json_decode($Response,TRUE);if($Ar["error"]){return $Ar["msg"];}else{return $Ar["short"];}}else{return $Response;}}?>

简单用法

<?phpecho shorten("https://baidu.com");?>

使用自定义短网址

<?phpecho shorten("https://baidu.com", "baidu");?>

使用自定义短网址和json格式

<?phpecho shorten("https://baidu.com", "baidu", "json");?>