# 接口目录: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 | 使用短链接的域名,可选值为:`fof.ink` | | suffix | 否 | string | 指定短网址后缀 | | password | 否 | string | 指定短网址密码 | | click\_limit | 否 | int | 指定短网址访问次数限制 | | fangfeng\_model| 否 | int | 开启微信QQ防红模式(参数 0 或者 1) | | expire | 否 | string | 自动下线时间,例如 2017-06-28 17:22:00 | | tag | 否 | string | 短网址的标签,用英文状态的逗号隔开,请注意单个标签只能包含字母、数字、汉字,不能包含特殊符号 | ### 返回示例: ~~~ { "status": 1, "info": "create short url success", "data": { "short_url": "https://fof.ink/demo" } } ~~~ ### 返回data字段说明: | 参数名 | 类型 | 说明 | | --- | --- | --- | | short\_url | string | 生成的短网址 | ### 备注: * tag字段发生错误不会有任何提示,请小心使用 * 一个用户最多只能有100个tag,请控制好数量