> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendify.dingstore.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# 查询联系人列表
> 分页查询当前账号下的联系人
分页查询当前 API Key 所属账号下的联系人。
```http theme={null}
GET https://api.sendify.dingstore.cn/dmx/v2/contacts
```
## 认证
在 `Authorization` 请求头中使用 Bearer API Key：
```http theme={null}
Authorization: Bearer YOUR_API_KEY
```
请勿在前端代码、公开仓库或日志中保存真实 API Key。
## 查询参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| - | - | - | - | - |
| `pageNo` | `number` | 否 | `1` | 页码，从 `1` 开始，必须是正整数。未传或传 `0` 时使用默认值；负数会导致请求失败 |
| `pageSize` | `number` | 否 | `50` | 每页返回的联系人数量，取值范围为 `1`～`1500`。未传或传 `0` 时使用默认值；负数或大于 `1500` 会导致请求失败 |
## 请求示例
以下示例查询第 `1` 页，每页返回 `50` 个联系人。
```bash theme={null}
curl -G \
"https://api.sendify.dingstore.cn/dmx/v2/contacts" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
--data-urlencode "pageNo=1" \
--data-urlencode "pageSize=50"
```
```typescript theme={null}
const url = new URL(
"https://api.sendify.dingstore.cn/dmx/v2/contacts"
);
url.searchParams.set("pageNo", "1");
url.searchParams.set("pageSize", "50");
const response = await fetch(url, {
headers: {
Authorization: "Bearer YOUR_API_KEY",
Accept: "application/json",
},
});
const data = await response.json();
console.log(data);
```
```python theme={null}
import requests
url = "https://api.sendify.dingstore.cn/dmx/v2/contacts"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
params = {
"pageNo": 1,
"pageSize": 50,
}
response = requests.get(url, headers=headers, params=params)
print(response.status_code)
print(response.text)
```
## 成功响应
HTTP `200` 返回当前页的联系人以及分页信息：
| 字段 | 类型 | 说明 |
| - | - | - |
| `contacts` | `array