核心功能
提供完整的API能力，满足企业级应用需求
照片批量同步
通过团队 ID 批量拉取水印照片列表，支持分页、时间区间等多种查询方式。
分页查询时间区间子团队过滤增量同步
水印元数据查询
按照片 ID 或时间批量获取水印元数据，涵盖时间、位置、设备等核心信息。
按 ID 查询按时间查询位置坐标设备信息
组织架构集成
完整的团队 / 部门 / 用户数据接口，与企业 HR 或 OA 系统无缝对接。
团队结构部门信息成员列表用户详情
高并发处理
高并发 API 调用，QPS 可达 1000+。提供 99.99% 的服务可用性保障。
1000+ QPS99.99%可用性自动扩容负载均衡
API调用示例
简单的API调用，即可获得强大的照片处理能力
照片列表查询
POST https://openapi.xhey.top/v2/group/photo
Content-Type: application/json
GroupKey: {{your_group_key}}
Timestamp: {{unix_timestamp}}
Signature: {{hmac_sha256_signature}}
{
"groupID": 42180013,
"pageNo": 1,
"pageSize": 20
}
// 响应示例
{
"code": 200,
"msg": "success",
"data": {
"hasMore": true,
"nextPageNo": 2,
"photos": [{
"id": 981090726,
"mediaUrl": "https://net-cloud.xhey.top/group/photo/xxx.jpg",
"mediaType": 0,
"time": 1627612397,
"userID": "open-0q325626-s606-93qr-33q9-n535snnoqn77"
}]
},
"timestamp": 1629100265
}按时间批量拉取水印
POST https://openapi.xhey.top/v2/group/watermark/byTime
Content-Type: application/json
GroupKey: {{your_group_key}}
Timestamp: {{unix_timestamp}}
Signature: {{hmac_sha256_signature}}
{
"groupID": 42180013,
"startTime": 1627000000,
"endTime": 1627612800,
"pageNo": 1,
"pageSize": 50
}
// 响应示例
{
"code": 200,
"msg": "success",
"data": {
"hasMore": false,
"watermarks": [{
"photoID": 981090726,
"time": 1627612397,
"lat": 39.9042,
"lng": 116.4074,
"address": "北京市朝阳区",
"userID": "open-0q325626-s606-93qr-33q9-n535snnoqn77"
}]
},
"timestamp": 1629100265
}水印元数据查询
POST https://openapi.xhey.top/v2/group/watermark/byPhotoId
Content-Type: application/json
GroupKey: {{your_group_key}}
Timestamp: {{unix_timestamp}}
Signature: {{hmac_sha256_signature}}
{
"photoIDs": [981090726, 981090725]
}
// 响应示例
{
"code": 200,
"msg": "success",
"data": {
"watermarks": [{
"photoID": 981090726,
"time": 1627612397,
"lat": 39.9042,
"lng": 116.4074,
"address": "北京市朝阳区",
"weather": "晴",
"temperature": 26
}]
},
"timestamp": 1629100265
}技术指标
行业领先的技术能力，为您的业务提供可靠保障
99.99%
API可用性
< 200ms
响应时间
1000+ QPS
并发处理
HmacSHA256
鉴权方式
典型应用场景
适用于多种业务场景，助力企业数字化转型
工程管理系统对接
将工程照片自动同步到管理系统，提取时间、地点等元数据，实现自动化管理
OA 考勤系统集成
集成水印拍照功能，自动记录考勤时间和位置，防止代打卡等作弊行为
巡检记录归档
批量处理巡检照片，自动添加水印和元数据，生成标准化巡检报告