你2短网址API接口说明文档

简介

你2短网址免费提供API接口供开发者调用,接口支持文本、json和xml格式。

所有接口都同时支持GET传参和POST传参,但我们建议使用POST传参。返回编码统一为UTF-8。

文本接口

地址:https://ni2.org/api/create

返回格式:成功返回链接地址;失败返回错误原因

JSON接口

地址:https://ni2.org/api/create.json

返回格式:

{"result":结果值,"result_text":"错误信息","url":生成的短网址}

XML接口

地址:https://ni2.org/api/create.xml

返回格式:

<xml>
	<result>结果值</result>
	<result_text>错误信息</result_text>
	<url>生成的短网址</url>
</xml>

请求参数

参数名 描述 必填
url 要缩短的网址。需要urlencode编码
user_key 用户标识,在会员中心可免费获取,使用用户标识生成的短网址可以在会员中心显示统计
hash 自定义短网址后缀,指定用户标识时才生效

返回参数

参数名 描述 备注
result 结果值

0-成功

1-生成URL失败

2-URL不符合格式

3-该域名已被加入黑名单

result_text 错误信息文本描述
url 生成的短网址