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

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

scope: users:read?limit=1…200?offset=0…1000000
POST/users

Create a managed workspace user.

scope: users:write
GET/users/{id}

Retrieve one tenant-scoped managed user.

scope: users:read
PATCH/users/{id}

Update supported profile fields or account status.

scope: users:write
DELETE/users/{id}

Soft-disable a user while retaining their audit history.

scope: users:write
POST/users/batch

Create, update, or disable up to 100 users with per-row results and idempotent replay.

scope: users:writeheader: Idempotency-Key
GET/signatures

List the 200 newest generated signature artifacts.

scope: signatures:read?user_id
GET/change-requests

List governed profile change requests.

scope: requests:read?status=pending|approved|rejected
GET/analytics

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

scope: analytics:read?days=1…365
GET/audiences

List reusable campaign audiences and resolved members.

scope: audiences:read
POST/audiences

Create or idempotently replace an API-managed audience.

scope: audiences:write
GET/audiences/{id}

Retrieve one audience with its resolved members.

scope: audiences:read
PUT/audiences/{id}

Replace an audience and its complete membership.

scope: audiences:write
DELETE/audiences/{id}

Delete a reusable audience.

scope: audiences:write
GET/webhooks

List signed webhook subscriptions without their secrets.

scope: webhooks:write
POST/webhooks

Create a subscription and receive its signing secret once.

scope: webhooks:write
PATCH/webhooks/{id}

Update, enable, or pause a webhook subscription.

scope: webhooks:write
DELETE/webhooks/{id}

Delete a webhook subscription.

scope: webhooks:write
GET/export

Download a versioned workspace configuration export without credentials, secrets, event history, or rebuildable artifacts.

scope: exports:read

需要帮助?

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

联系支持