跳转到主要内容
POST
curl
该凭证由设备端通道使用,相关说明见 SDK 事件提交。该页还列出了服务器对每个设备端请求强制执行的规则,以及在背压情况下可以安全丢弃哪些事件。

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。

请求体

application/json

支持驼峰命名(camelCase)别名:vendorData、entityType、allowedEventCategories、ttlSeconds、maxUses、bindToOrigin。

vendor_data
string
必填

您对使用此凭据提交的每个事件所属主体的 ID。

Required string length: 1 - 255
entity_type
string
默认值:individual

company 绑定企业主体;任何其他值(默认 individual)绑定个人。

Maximum string length: 32
allowed_event_categories
enum<string>[]

该凭证可以提交的类别。省略或发送 [] 以允许所有类别。

可用选项:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
默认值:900

凭据的生命周期(秒)。

必填范围: 60 <= x <= 86400
max_uses
integer | null
默认值:1000

该凭据可提交的事件数量(批处理中的每个事件消耗一次使用次数)。传入 null 表示有效期内不设上限。

必填范围: x >= 1
bind_to_origin
string | null

设置后,每个设备请求的浏览器 Origin 请求头必须完全等于此值;没有 Origin 的请求将被拒绝。

Maximum string length: 255

响应

凭证已生成。请将 monitoring_token 传递给应用,并在 expires_at 之前将其视为秘密。

monitoring_token
string
必填

设备凭证(43 个字符的 URL 安全 token)。请在 X-Monitoring-Token 请求头中发送。

expires_at
string<date-time>
必填

凭据停止被接受的时间。

allowed_event_categories
enum<string>[]
必填

该凭证可以提交的类别;[] 表示所有类别。

可用选项:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
max_uses
integer | null
必填

凭据的事件预算;null 表示无上限。

bind_to_origin
string | null
必填

凭据绑定的来源(Origin),或 null。

最后修改于 2026年11月7日