服务端事件接入

订单、支付、注册等必须由后端确认的事件，应从「项目设置 → 服务端接入」上报。Owner / Admin 可以创建和吊销项目级 Ingest Key；Member 可查看说明与示例；Viewer 不显示该入口。

新 Key 只显示一次。请立即保存到服务器密钥管理系统，并通过环境变量 IRIS_EVENT_KEY 注入；不要写进源码、前端代码、聊天或日志。页面示例始终读取环境变量，不会嵌入真实 Key。

export IRIS_EVENT_KEY='从密钥管理系统读取'
export IRIS_ENDPOINT='https://iris.teown.com/api/server/collect'

# 仓库中的完整可运行示例
bash examples/server-ingest/curl.sh
php examples/server-ingest/php.php
node examples/server-ingest/node.mjs
python3 examples/server-ingest/python.py

每个事件都要提供稳定且唯一的 event_id。网络失败、429 或 5xx 最多重试 3 次，并在重试中复用原 event_id；400 / 401 / 403 等错误应先修正请求或 Key，不要盲目重试。

HTTP 202 仅表示请求已校验并进入异步队列，通常 1 分钟内可在事件和回放中查询。事件名为 1～50 位字母、数字或下划线且以字母开头，禁止使用 $ 开头的系统事件名。