快速入门

让你的第一个 API 调用跑起来

五个步骤搭建可用后端，约 2 分钟。

2 分钟即可运行

通往可用后端的最短路径。完成这五个步骤，复制每段代码，即可上线。需要更多细节？每个步骤都链接到完整指南。

创建你的免费账户

几秒即可注册，然后在下一步获取你的 API 密钥。

免费开始

代码片段使用欧盟区域（eu.horizon.pm）。请根据你的项目区域替换为 us. 或 as.。

创建项目 API 密钥

打开 Dashboard，然后进入 API Keys，创建项目密钥并保留以备后续步骤使用。

X-API-Key: horizon_YOUR_API_KEY_HERE

粘贴 SDK 配置

此结构适用于 Unity、Godot、Unreal 或自定义 REST 客户端。

{
  "apiKey": "horizon_YOUR_API_KEY_HERE",
  "backendDomains": ["https://eu.horizon.pm"]
}

匿名登录

无需注册即可创建玩家，并返回用户 id 供后续调用使用。

curl -X POST https://eu.horizon.pm/api/v1/app/user-management/signup \
  -H "Content-Type: application/json" \
  -H "X-API-Key: horizon_YOUR_API_KEY_HERE" \
  -d '{"type":"ANONYMOUS","username":"TestPlayer"}'

写入第一个云存档

使用返回的用户 id 并存储一个小的 JSON 负载。

curl -X POST https://eu.horizon.pm/api/v1/app/cloud-save/save \
  -H "Content-Type: application/json" \
  -H "X-API-Key: horizon_YOUR_API_KEY_HERE" \
  -d '{"userId":"USER_UUID","saveData":"{\"level\":1,\"coins\":50}"}'

读取游戏配置

确认实时服务器数据无需重新构建应用即可到达客户端。

curl https://eu.horizon.pm/api/v1/app/remote-config/all \
  -H "X-API-Key: horizon_YOUR_API_KEY_HERE"

完成。你的后端可以接受写入和读取。你的应用已连接。

你将解锁

身份验证、排行榜、云存档、崩溃报告、日志、远程配置、新闻、邮件、礼品码和反馈，全部使用同一个 API 密钥。