hi-server/cmd/test_openinstall

OpenInstall API 测试结果

测试总结

✅ 成功连接到 OpenInstall API

• API 基础 URL: https://data.openinstall.com
• 测试的接口端点工作正常
• HTTP 状态码: 200

当前问题

❌ ApiKey 配置错误

API 返回错误: code=3, error="apiKey错误"

问题分析

当前配置中:

• AppKey: alf57p - 这是应用的标识符(AppKey),用于 SDK 集成
• 但数据接口需要的是单独的 apiKey,这两者不同

解决方案

步骤 1: 在 OpenInstall 后台配置数据接口

1. 登录 OpenInstall 后台: https://www.openinstall.com
2. 找到 【数据接口】-【接口配置】 菜单
3. 开启数据接口开关
4. 获取 apiKey (这是专门用于数据接口的密钥,不同于 AppKey)

步骤 2: 更新配置文件

在 ppanel-server/etc/ppanel.yaml 中添加 ApiKey:

OpenInstall:
  Enable: true
  AppKey: "alf57p"      # SDK 集成使用
  ApiKey: "your_api_key_from_backend"  # 数据接口使用

步骤 3: 重新测试

获取到正确的 apiKey 后,运行测试程序:

cd cmd/test_openinstall
go run main.go

测试接口说明

测试程序当前测试了以下接口:

1. 新增安装数据 (Growth Data)

• 端点: /data/event/growth
• 功能: 获取指定时间范围内的访问量、点击量、安装量、注册量及留存数据
• 参数:
  • apiKey: 数据接口密钥
  • startDate: 开始日期 (格式: 2006-01-02)
  • endDate: 结束日期
  • statType: 统计类型 (daily=按天, hourly=按小时, total=合计)

返回数据包括:

• visit: 访问量
• click: 点击量
• install: 安装量
• register: 注册量
• survive_d1: 1日留存
• survive_d7: 7日留存
• survive_d30: 30日留存

2. 渠道列表 (Channel List)

• 端点: /data/channel/list
• 功能: 获取 H5 渠道列表
• 参数:
  • apiKey: 数据接口密钥
  • pageNum: 页码
  • pageSize: 每页数量

更多可用接口

OpenInstall 数据接口还提供以下功能:

• 渠道分组管理 (创建、修改、删除)
• 渠道管理 (创建、修改、删除、查询)
• 子渠道管理
• 存量设备数据
• 活跃数据统计
• 效果点数据
• 设备分布统计

详细文档: https://www.openinstall.com/doc/data.html

下一步建议

1. 配置 ApiKey: 按照上述步骤在 OpenInstall 后台获取并配置 apiKey
2. 更新配置: 将 apiKey 添加到 ppanel.yaml 配置文件
3. 更新代码: 修改 pkg/openinstall/openinstall.go 实现真实的 API 调用
4. 测试验证: 重新运行测试程序验证数据获取