API文档

如果需要帮助,你还可以
发邮件至:admin@955.cc
我们会24小时内给你回复

▲ 返回顶部

API 简介

API允许第三方自由调用URL缩短或者URL还原,基于txt/json/jsonp模式。

目前没有针对用户的请求频数做限制,但是如果滥用或造成资源浪费,将可能会自动被封禁IP段。

现在 955 短网址已经支持 https 的调用(spdy)。您现在还可以调用 https://955.cc/short/,并且支持https访问生成的短网址。

1、简单模式

请求 955.cc/short/?url=baidu.com 返回txt明文,为压缩过后的网址。

http://955.cc/ay
如果出错则将返回类似这样的格式:
提示:你所输入的网址(URL)是不允许的。(-2) 

2、json

请求 955.cc/short/?url=baidu.com&format=json 返回json数据

{
    "errno":0,
    "url":"http:\/\/955.cc\/ay",
    "error":""
}
如果 errno 为0说明成功,-1为URL因为安全原因被拦截,拦截原因见error。

3、jsonp

请求方式同上,但是format为jsonp,并要指定callback,

例如:955.cc/short/?url=baidu.com&format=jsonp&callback=test 将会返回类似数据:

test({
    "errno":0,
    "url":"http:\/\/955.cc\/ay",
    "error":""
})

还原

如果请求的url参数格式是 http://955.cc/([a-zA-Z0-9]+) 则返回结果里的url显示的是原始URL。

例如:http://955.cc/short/?url=955.cc/ay&format=jsonp&callback=test 返回

test({
    "errno":0,
    "error":"",
    "url":"http:\/\/baidu.com"
})

错误代码

  1. 0 为成功无错。
  2. -1为因为安全原因被拦截。拦截原因见 error 的说明。

        我们的系统会查询国内主流安全商并封禁威胁用户安全的网址。如果出现误报请邮件联系管理员。

  3. -2 为其他错误,往往是格式不对。
  4. -3是指定为jsonp时,如果未指定callback存会出现此错误。
  5. 如果内容为空或者http状态码非200,则说明系统出现异常,需要稍后再试。

使用的例子:

在jQuery中使用的例子:

$.getJSON('http://955.cc/short/?url=' + encodeURIComponent('http://baidu.com') + '&format=jsonp&callback=?',
    function(data){
    	if(data.errno == 0) {
    		alert(data.url);
    	}
    }
);

在Python中使用的例子:

#coding=utf8
import urllib2
content = urllib2.urlopen("http://955.cc/short/?url=www.douban.com").read() 
print content 

在Ruby中使用的例子:

require "open-uri"
content = open('http://955.cc/short/?url=www.douban.com').read
print content

在PHP中使用的例子:

<?php
    $content = file_get_contents("http://955.cc/short/?url=" . urlencode($_SERVER['HTTP_HOST'])."&format=json");
    var_dump(json_decode($content,1));

QRCode 二维码调用

调用格式为 http://955.cc/短地址代码.qr,例如: 「http://955.cc/ay.qr」,显示结果为:

此外如需为QR码指定尺寸,可以附带size参数,为图片的像素宽/高。例如:

http://955.cc/ay.qr?size=500
需要注意的是,1、尺寸大小范围为30~1000px。2、尽量使用常见取整的像素值,例如 120px、200px,未来可能会对传入尺寸化去不常见格式的个位数,以助于Cache。