三步开始你的第一个集成
无需复杂配置，注册应用后即可调用测试接口。
1
创建开发者账号
在 SafeW 开发者后台注册应用，获取专属的 API Key 和 Secret。
2
选择 SDK 或 REST API
下载对应语言的 SDK（Python、JavaScript、Java、Go 等），或直接调用 REST 端点。
3
沙箱调试与上线
在沙箱环境中测试消息收发、加密验证等流程，确认无误后切换到生产环境。
核心 API 能力一览
覆盖安全通讯的所有关键环节，开箱即用。
端到端加密消息
发送和接收端到端加密的文本、文件、语音消息，密钥自动管理。
POST /v1/messages身份可信验证
创建匿名身份、验证设备指纹、签发短期会话令牌。
POST /v1/identities消息生命周期管控
设置阅后即焚、远程销毁、自毁定时器，控制消息存留时间。
DELETE /v1/messages/{id}多设备同步
管理用户多个设备，实时同步消息状态和会话列表。
GET /v1/devices事件回调通知
通过 Webhook 接收消息已读、设备上线、登录异常等事件。
POST /v1/webhooks安全审计日志
获取 API 调用日志和安全事件记录，满足合规审计要求。
GET /v1/audit-logs从代码到加密，
只需几行
以下示例展示如何用 Python SDK 发送一条阅后即焚的加密消息。
Python
from safew_sdk import SafeWClient
client = SafeWClient(api_key="your_api_key", secret="your_secret")
# 创建匿名身份
alice = client.create_identity(alias="alice")
bob = client.create_identity(alias="bob")
# 发送阅后即焚消息（10秒后销毁）
message = client.send_message(
sender=alice.id,
recipient=bob.id,
content="项目报价：300万",
burn_after_seconds=10,
screenshot_protection=True
)
print(f"消息ID: {message.id}，已加密发送，10秒后自动销毁")
所有 SDK 均包含完整的错误处理与重试机制，并支持离线存储加密消息队列。
沙箱 API 地址
https://sandbox.safewiuapp.com.cn/v1
测试密钥示例
sk_test_51HdFkLmN... (请替换为自己的密钥)
开发者常见问题
API 调用有速率限制吗？
是的，免费套餐默认限制 60 次/分钟，企业版可根据需要提升。您可以在开发者后台查看当前用量和限制。
如何实现端到端加密的消息撤回？
使用 DELETE /v1/messages/{id} 接口即可远程销毁消息，无论对方是否已读。该操作会同步删除所有设备上的副本。
支持私有化部署吗？
支持。企业版可将 API 服务完全部署在您的内网，文档和 SDK 同样适用。请联系销售获取部署包。
错误码在哪里查看？
每个 API 响应都包含标准错误码（如 401 未授权、429 限流）。完整错误码表在文档的“错误处理”章节。