> ## 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 所属账号下的联系人。接口不会暴露内部联系人 ID。
```http theme={null}
GET https://api.sendify.dingstore.cn/dmx/v2/contacts/{email}
```
## 认证
在 `Authorization` 请求头中使用 Bearer API Key：
```http theme={null}
Authorization: Bearer YOUR_API_KEY
```
请勿在前端代码、公开仓库或日志中保存真实 API Key。
## 路径参数
| 参数 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `email` | `string` | 是 | 要查询的联系人邮件地址，按完整邮件地址精确匹配。放入 URL 路径前需要进行 URL 编码 |
## 请求示例
```bash theme={null}
curl \
"https://api.sendify.dingstore.cn/dmx/v2/contacts/zhangsan%40example.com" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"
```
```typescript theme={null}
const email = "zhangsan@example.com";
const url =
"https://api.sendify.dingstore.cn/dmx/v2/contacts/" +
encodeURIComponent(email);
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}
from urllib.parse import quote
import requests
email = "zhangsan@example.com"
encoded_email = quote(email, safe="")
url = (
"https://api.sendify.dingstore.cn/dmx/v2/contacts/"
+ encoded_email
)
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.status_code)
print(response.text)
```
## 成功响应
HTTP `200` 返回与邮件地址匹配的联系人：
| 字段 | 类型 | 说明 |
| - | - | - |
| `contact` | `object` | 与请求邮件地址匹配的联系人 |
| `contact.firstName` | `string` | 联系人的名字，可以为空 |
| `contact.lastName` | `string` | 联系人的姓氏，可以为空 |
| `contact.company` | `string \| null` | 联系人所在公司，可以为 `null` |
| `contact.position` | `string` | 联系人的职位，可以为空 |
| `contact.source` | `string` | 联系人的创建来源，可选值见下表 |
| `contact.createTime` | `string (date-time)` | 联系人创建时间，RFC 3339 格式的 UTC 时间戳 |
| `contact.customFields` | `array