291 lines
8.3 KiB
Go
291 lines
8.3 KiB
Go
package openinstall
|
||
|
||
import (
|
||
"context"
|
||
"encoding/json"
|
||
"fmt"
|
||
"io"
|
||
"net/http"
|
||
"net/url"
|
||
"time"
|
||
)
|
||
|
||
var (
|
||
// OpenInstall 数据接口基础 URL
|
||
apiBaseURL = "https://data.openinstall.com"
|
||
)
|
||
|
||
// Client for OpenInstall API
|
||
type Client struct {
|
||
apiKey string
|
||
httpClient *http.Client
|
||
}
|
||
|
||
// NewClient creates a new OpenInstall client
|
||
// apiKey: OpenInstall 数据接口 ApiKey
|
||
func NewClient(apiKey string) *Client {
|
||
return &Client{
|
||
apiKey: apiKey,
|
||
httpClient: &http.Client{
|
||
Timeout: 10 * time.Second,
|
||
},
|
||
}
|
||
}
|
||
|
||
// PlatformStats represents statistics for a specific platform
|
||
type PlatformStats struct {
|
||
Platform string `json:"platform"`
|
||
Count int64 `json:"count"` // 下载/安装量
|
||
}
|
||
|
||
// PlatformDownloads 各端下载量统计
|
||
type PlatformDownloads struct {
|
||
Total int64 `json:"total"` // 总量
|
||
IOS int64 `json:"ios"` // iOS
|
||
Android int64 `json:"android"` // Android
|
||
Windows int64 `json:"windows"` // Windows
|
||
Mac int64 `json:"mac"` // Mac
|
||
Comparison *MonthComparison `json:"comparison"` // 环比数据
|
||
}
|
||
|
||
// MonthComparison 月度对比数据
|
||
type MonthComparison struct {
|
||
LastMonthTotal int64 `json:"lastMonthTotal"` // 上月总量
|
||
Change int64 `json:"change"` // 变化量 (正数=增长, 负数=下降)
|
||
ChangePercent float64 `json:"changePercent"` // 变化百分比
|
||
}
|
||
|
||
// APIResponse 通用响应结构
|
||
type APIResponse struct {
|
||
Code int `json:"code"`
|
||
Error *string `json:"error"`
|
||
Body json.RawMessage `json:"body"`
|
||
}
|
||
|
||
// GrowthData 新增安装数据
|
||
type GrowthData struct {
|
||
Date string `json:"date"`
|
||
Visit int64 `json:"visit"` // 访问量
|
||
Click int64 `json:"click"` // 点击量
|
||
Install int64 `json:"install"` // 安装量
|
||
Register int64 `json:"register"` // 注册量
|
||
SurviveD1 int64 `json:"survive_d1"` // 1日留存
|
||
SurviveD7 int64 `json:"survive_d7"` // 7日留存
|
||
SurviveD30 int64 `json:"survive_d30"` // 30日留存
|
||
}
|
||
|
||
// DistributionData 设备分布数据
|
||
type DistributionData struct {
|
||
Key string `json:"key"`
|
||
Value int64 `json:"value"`
|
||
}
|
||
|
||
// GetPlatformDownloads 获取各端下载量统计（当月数据 + 环比）
|
||
func (c *Client) GetPlatformDownloads(ctx context.Context, channel string) (*PlatformDownloads, error) {
|
||
now := time.Now()
|
||
|
||
// 当月数据：本月1号到今天
|
||
startOfMonth := time.Date(now.Year(), now.Month(), 1, 0, 0, 0, 0, now.Location())
|
||
endOfMonth := now
|
||
|
||
// 上月数据：上月1号到上月最后一天
|
||
startOfLastMonth := startOfMonth.AddDate(0, -1, 0)
|
||
endOfLastMonth := startOfMonth.AddDate(0, 0, -1)
|
||
|
||
// 获取当月各平台数据
|
||
currentMonthData, err := c.getPlatformData(ctx, startOfMonth, endOfMonth, channel)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to get current month data: %w", err)
|
||
}
|
||
|
||
// 获取上月各平台数据
|
||
lastMonthData, err := c.getPlatformData(ctx, startOfLastMonth, endOfLastMonth, channel)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to get last month data: %w", err)
|
||
}
|
||
|
||
// 计算总量
|
||
currentTotal := currentMonthData.IOS + currentMonthData.Android + currentMonthData.Windows + currentMonthData.Mac
|
||
lastTotal := lastMonthData.IOS + lastMonthData.Android + lastMonthData.Windows + lastMonthData.Mac
|
||
|
||
// 计算环比
|
||
change := currentTotal - lastTotal
|
||
changePercent := float64(0)
|
||
if lastTotal > 0 {
|
||
changePercent = (float64(change) / float64(lastTotal)) * 100
|
||
}
|
||
|
||
return &PlatformDownloads{
|
||
Total: currentTotal,
|
||
IOS: currentMonthData.IOS,
|
||
Android: currentMonthData.Android,
|
||
Windows: currentMonthData.Windows,
|
||
Mac: currentMonthData.Mac,
|
||
Comparison: &MonthComparison{
|
||
LastMonthTotal: lastTotal,
|
||
Change: change,
|
||
ChangePercent: changePercent,
|
||
},
|
||
}, nil
|
||
}
|
||
|
||
// getPlatformData 获取指定时间范围内各平台的数据
|
||
func (c *Client) getPlatformData(ctx context.Context, startDate, endDate time.Time, channel string) (*PlatformDownloads, error) {
|
||
result := &PlatformDownloads{}
|
||
|
||
// 获取 iOS 数据
|
||
iosData, err := c.getDeviceDistribution(ctx, startDate, endDate, "ios", "total", channel)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to get iOS data: %w", err)
|
||
}
|
||
for _, item := range iosData {
|
||
result.IOS += item.Value
|
||
}
|
||
|
||
// 获取 Android 数据
|
||
androidData, err := c.getDeviceDistribution(ctx, startDate, endDate, "android", "total", channel)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to get Android data: %w", err)
|
||
}
|
||
for _, item := range androidData {
|
||
result.Android += item.Value
|
||
}
|
||
|
||
// Windows 和 Mac 暂时设为 0 (需要从其他数据源获取)
|
||
result.Windows = 0
|
||
result.Mac = 0
|
||
|
||
return result, nil
|
||
}
|
||
|
||
// getDeviceDistribution 获取设备分布数据
|
||
func (c *Client) getDeviceDistribution(ctx context.Context, startDate, endDate time.Time, platform, sumBy, channel string) ([]DistributionData, error) {
|
||
apiURL := fmt.Sprintf("%s/data/sum/growth", apiBaseURL)
|
||
|
||
params := url.Values{}
|
||
params.Add("apiKey", c.apiKey)
|
||
params.Add("beginDate", startDate.Format("2006-01-02"))
|
||
params.Add("endDate", endDate.Format("2006-01-02"))
|
||
params.Add("platform", platform)
|
||
params.Add("sumBy", sumBy)
|
||
if channel != "" {
|
||
params.Add("channelCode", channel)
|
||
}
|
||
params.Add("excludeDuplication", "0")
|
||
|
||
fullURL := fmt.Sprintf("%s?%s", apiURL, params.Encode())
|
||
|
||
req, err := http.NewRequestWithContext(ctx, http.MethodGet, fullURL, nil)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to create request: %w", err)
|
||
}
|
||
|
||
resp, err := c.httpClient.Do(req)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to send request: %w", err)
|
||
}
|
||
defer resp.Body.Close()
|
||
|
||
body, err := io.ReadAll(resp.Body)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to read response: %w", err)
|
||
}
|
||
|
||
var apiResp APIResponse
|
||
if err := json.Unmarshal(body, &apiResp); err != nil {
|
||
return nil, fmt.Errorf("failed to parse response: %w", err)
|
||
}
|
||
|
||
if apiResp.Code != 0 {
|
||
errMsg := "unknown error"
|
||
if apiResp.Error != nil {
|
||
errMsg = *apiResp.Error
|
||
}
|
||
return nil, fmt.Errorf("API error (code=%d): %s", apiResp.Code, errMsg)
|
||
}
|
||
|
||
var distData []DistributionData
|
||
if err := json.Unmarshal(apiResp.Body, &distData); err != nil {
|
||
return nil, fmt.Errorf("failed to parse distribution data: %w", err)
|
||
}
|
||
|
||
return distData, nil
|
||
}
|
||
|
||
// GetPlatformStats 获取平台统计数据（兼容旧接口）
|
||
func (c *Client) GetPlatformStats(ctx context.Context, startDate, endDate time.Time) ([]PlatformStats, error) {
|
||
// 调用新增安装数据接口
|
||
growthData, err := c.GetGrowthData(ctx, startDate, endDate, "total")
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to get growth data: %w", err)
|
||
}
|
||
|
||
// 如果没有数据,返回空列表
|
||
if len(growthData) == 0 {
|
||
return []PlatformStats{}, nil
|
||
}
|
||
|
||
// 合并所有数据
|
||
var totalVisits, totalClicks int64
|
||
for _, data := range growthData {
|
||
totalVisits += data.Visit
|
||
totalClicks += data.Click
|
||
}
|
||
|
||
return []PlatformStats{
|
||
{
|
||
Platform: "All",
|
||
Count: totalVisits + totalClicks,
|
||
},
|
||
}, nil
|
||
}
|
||
|
||
// GetGrowthData 获取新增安装数据
|
||
func (c *Client) GetGrowthData(ctx context.Context, startDate, endDate time.Time, statType string) ([]GrowthData, error) {
|
||
apiURL := fmt.Sprintf("%s/data/event/growth", apiBaseURL)
|
||
|
||
params := url.Values{}
|
||
params.Add("apiKey", c.apiKey)
|
||
params.Add("startDate", startDate.Format("2006-01-02"))
|
||
params.Add("endDate", endDate.Format("2006-01-02"))
|
||
params.Add("statType", statType)
|
||
|
||
fullURL := fmt.Sprintf("%s?%s", apiURL, params.Encode())
|
||
|
||
req, err := http.NewRequestWithContext(ctx, http.MethodGet, fullURL, nil)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to create request: %w", err)
|
||
}
|
||
|
||
resp, err := c.httpClient.Do(req)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to send request: %w", err)
|
||
}
|
||
defer resp.Body.Close()
|
||
|
||
body, err := io.ReadAll(resp.Body)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("failed to read response: %w", err)
|
||
}
|
||
|
||
var apiResp APIResponse
|
||
if err := json.Unmarshal(body, &apiResp); err != nil {
|
||
return nil, fmt.Errorf("failed to parse response: %w", err)
|
||
}
|
||
|
||
if apiResp.Code != 0 {
|
||
errMsg := "unknown error"
|
||
if apiResp.Error != nil {
|
||
errMsg = *apiResp.Error
|
||
}
|
||
return nil, fmt.Errorf("API error (code=%d): %s", apiResp.Code, errMsg)
|
||
}
|
||
|
||
var growthData []GrowthData
|
||
if err := json.Unmarshal(apiResp.Body, &growthData); err != nil {
|
||
return nil, fmt.Errorf("failed to parse growth data: %w", err)
|
||
}
|
||
|
||
return growthData, nil
|
||
}
|