API v1.0

开发者 API

将 SignaGenius 集成到您现有的工作流程中。我们的 REST API 允许您以编程方式管理团队成员、触发同步并获取实时分析。

认证

所有 API 请求都必须使用 Bearer 令牌进行身份验证。您可以在 管理面板 > 设置 > 开发者 中生成您的 API 密钥。

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://panel.signagenius.com/api/v1/users

端点

GET/users

列出所有团队成员及其签名状态。

权限范围:users:read?limit=1...200?offset=0...1000000
POST/users

创建一个受管的工作区用户。

权限范围:users:write
GET/users/{id}

获取租户范围内的一个受管用户。

权限范围:users:read
PATCH/users/{id}

更新受支持的资料字段或账户状态。

权限范围:users:write
DELETE/users/{id}

软性停用某个用户,同时保留其审计历史。

权限范围:users:write
POST/users/batch

批量创建、更新或停用最多 100 个用户,逐行返回结果并支持幂等重放。

权限范围:users:writeheader: Idempotency-Key
GET/signatures

列出最新生成的 200 个签名产物。

权限范围:signatures:read?user_id
GET/change-requests

列出受管控的资料变更请求。

权限范围:requests:read?status=pending|approved|rejected
GET/analytics

检索特定时间范围内的链接点击分析。

权限范围:analytics:read?days=1...365
GET/audiences

列出可复用的营销受众及其解析后的成员。

权限范围:audiences:read
POST/audiences

创建或以幂等方式替换由 API 管理的受众。

权限范围:audiences:write
GET/audiences/{id}

获取某个受众及其解析后的成员。

权限范围:audiences:read
PUT/audiences/{id}

替换某个受众及其全部成员。

权限范围:audiences:write
DELETE/audiences/{id}

删除一个可复用的受众。

权限范围:audiences:write
GET/webhooks

列出已签名的 Webhook 订阅,但不含其密钥。

权限范围:webhooks:write
POST/webhooks

创建订阅并一次性获取其签名密钥。

权限范围:webhooks:write
PATCH/webhooks/{id}

更新、启用或暂停某个 Webhook 订阅。

权限范围:webhooks:write
DELETE/webhooks/{id}

删除某个 Webhook 订阅。

权限范围:webhooks:write
GET/export

下载带版本的工作区配置导出,不含凭据、密钥、事件历史或可重建的产物。

权限范围:exports:read

需要帮助?

我们的工程团队随时为您提供集成帮助。

联系支持