# 接口目录:urls/add
* * *
### 简要描述:
* 创建一条新的短链接
* 如果需要大量添加链接,正确的方式是使用批量接口,否则不停循环调用本接口将产生**巨额的调用费**
### 调用收费:
> 1添加额度/次 + 1点击额度/次
### 是否需要授权才能调用:
**是**,详情请参阅左侧导航《接口鉴权》小节
### 请求URL:
~~~
http://api.fof.ink/urls/add
~~~
### 请求方式:
`POST`
### 请求参数:
| 参数名 | 是否必须 | 类型 | 说明 |
| --- | --- | --- | --- |
| real\_url | 是 | string | 需要缩短的原始长网址 |
| nht\_protect | 否 | int | 是否开启nht保护,默认1,即开启,关闭请传递0 |
| source | 否 | string | 渠道/客户号标记,短信营销用的链接,此处请填写链接接受者的手机号 |
| domain | 否 | string | 使用短链接的域名,可定义域名或为空 |
| suffix | 否 | string | 指定短网址后缀 |
| password | 否 | string | 指定短网址密码 |
| click\_limit | 否 | int | 指定短网址访问次数限制 |
| fangfeng\_model| 否 | int | 开启微信QQ防红模式(参数 0 或者 1) |
|is_moblie|否|int|是否限制电脑端打开 1为是 0为否|
| expire | 否 | string | 自动下线时间,例如 2017-06-28 17:22:00 |
| tag | 否 | string | 短网址的标签,用英文状态的逗号隔开,请注意单个标签只能包含字母、数字、汉字,不能包含特殊符号 |
### 返回示例:
~~~
{
"status": 1,
"info": "create short url success",
"data": {
"short_url": "https://fof.ink/demo",
"wx_sort_url":"https://t.cn/xxx"
}
}
~~~
### 返回data字段说明:
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| short\_url | string | 生成的平台短网址 |
| wx_sort_url | string | 生成的防封短网址 |
### 备注:
* tag字段发生错误不会有任何提示,请小心使用
* 一个用户最多只能有100个tag,请控制好数量