# 接口目录：urls/batchAdd
* * *
### 简要描述：
* 批量添加短网址，每条可以自定义参数，一次最多100条
### 调用收费：
> 1点击额度/次 + 生成的短网址同等数量的添加额度
### 是否需要授权才能调用：
**是**，详情请参阅左侧导航《接口鉴权》小节
### 请求URL：
~~~
http://api.fof.ink/urls/batchAdd
~~~
### 请求方式：
`POST`
### 请求参数：
| 参数名 | 是否必须 | 类型 | 说明 |
| --- | --- | --- | --- |
| payload | 是 | string | JSON字符串，用来标示批量任务属性 |
### payload参数详解：
* payload中每个元素参数可以参考urls/add接口的参数，另外需要加一个必有字段index，该字段最后会被原样返还，方便客户端标记对应的长网址，多个元素打包成数组，转换为 JSON 格式，**请注意：一次最多添加100条**
#### payload示例
~~~
[
{
"index": "index1",
"real_url": "http://www.163.com"
},
{
"index": "index2",
"real_url": "http://www.163.com",
"nht_protect": 0
},
{
"index": "index3",
"real_url": "http://www.163.com",
"tag": "标签1,标签2",
"suffix":"abc"
}
]
~~~
### 返回示例：
~~~
{
"status": 1,
"info": "batch task execute success",
"data": [
{
"index": "index1",
"status": 1,
"info": "create short url success",
"data": "https://fof.ink/ltuK"
},
{
"index": "index2",
"status": 1,
"info": "create short url success",
"data": "https://fof.ink/DcEs"
},
{
"index": "index3",
"status": 0,
"info": "backfix dumped",
"data": ""
}
]
}
~~~
### 返回data字段说明：
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| N/A | array | 生成的短网址列表，payload里设置了多少条，这里就有多少条，每条里的index是按照客户端编号原样返回 |
### 备注：
* data字段里不是每个payload任务都会执行成功，请参考示例自行编写代码处理逻辑
