Playlyfe REST API 集成开发指南

Playlyfe 是一个游戏化平台，提供API用于构建游戏化应用。下面我将介绍如何在Go语言中集成Playlyfe的REST API。

基本设置

首先需要安装必要的依赖：

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
	"time"
)

认证配置

Playlyfe使用OAuth2进行认证，我们需要配置客户端凭证：

type PlaylyfeClient struct {
	ClientID     string
	ClientSecret string
	RedirectURI  string
	AccessToken  string
	ExpiresAt    time.Time
	HTTPClient   *http.Client
}

func NewPlaylyfeClient(clientID, clientSecret, redirectURI string) *PlaylyfeClient {
	return &PlaylyfeClient{
		ClientID:     clientID,
		ClientSecret: clientSecret,
		RedirectURI:  redirectURI,
		HTTPClient:   &http.Client{Timeout: 10 * time.Second},
	}
}

获取访问令牌

func (c *PlaylyfeClient) GetAccessToken(code string) error {
	url := "https://api.playlyfe.com/v1/oauth/token"
	
	payload := map[string]string{
		"client_id":     c.ClientID,
		"client_secret": c.ClientSecret,
		"redirect_uri":  c.RedirectURI,
		"grant_type":    "authorization_code",
		"code":          code,
	}

	jsonPayload, _ := json.Marshal(payload)
	resp, err := c.HTTPClient.Post(url, "application/json", bytes.NewBuffer(jsonPayload))
	if err != nil {
		return err
	}
	defer resp.Body.Close()

	body, _ := ioutil.ReadAll(resp.Body)
	
	var result struct {
		AccessToken string `json:"access_token"`
		ExpiresIn   int    `json:"expires_in"`
	}
	
	if err := json.Unmarshal(body, &result); err != nil {
		return err
	}

	c.AccessToken = result.AccessToken
	c.ExpiresAt = time.Now().Add(time.Duration(result.ExpiresIn) * time.Second)
	
	return nil
}

基础API请求方法

func (c *PlaylyfeClient) makeRequest(method, endpoint string, data interface{}) ([]byte, error) {
	if time.Now().After(c.ExpiresAt) {
		return nil, fmt.Errorf("access token expired")
	}

	url := fmt.Sprintf("https://api.playlyfe.com/v1%s", endpoint)
	
	var req *http.Request
	var err error
	
	if data != nil {
		jsonData, _ := json.Marshal(data)
		req, err = http.NewRequest(method, url, bytes.NewBuffer(jsonData))
		req.Header.Set("Content-Type", "application/json")
	} else {
		req, err = http.NewRequest(method, url, nil)
	}
	
	if err != nil {
		return nil, err
	}
	
	req.Header.Set("Authorization", "Bearer "+c.AccessToken)
	
	resp, err := c.HTTPClient.Do(req)
	if err != nil {
		return nil, err
	}
	defer resp.Body.Close()
	
	body, err := ioutil.ReadAll(resp.Body)
	if err != nil {
		return nil, err
	}
	
	if resp.StatusCode >= 400 {
		return nil, fmt.Errorf("API error: %s", string(body))
	}
	
	return body, nil
}

常用API操作示例

获取玩家信息

func (c *PlaylyfeClient) GetPlayer(playerID string) (map[string]interface{}, error) {
	endpoint := fmt.Sprintf("/player/%s", playerID)
	body, err := c.makeRequest("GET", endpoint, nil)
	if err != nil {
		return nil, err
	}
	
	var player map[string]interface{}
	if err := json.Unmarshal(body, &player); err != nil {
		return nil, err
	}
	
	return player, nil
}

更新玩家分数

func (c *PlaylyfeClient) UpdatePlayerScore(playerID, metric string, value int) error {
	endpoint := fmt.Sprintf("/player/%s/action/score", playerID)
	data := map[string]interface{}{
		"metric": metric,
		"value":  value,
	}
	
	_, err := c.makeRequest("POST", endpoint, data)
	return err
}

获取排行榜

func (c *PlaylyfeClient) GetLeaderboard(leaderboardID string) ([]map[string]interface{}, error) {
	endpoint := fmt.Sprintf("/leaderboard/%s", leaderboardID)
	body, err := c.makeRequest("GET", endpoint, nil)
	if err != nil {
		return nil, err
	}
	
	var leaderboard []map[string]interface{}
	if err := json.Unmarshal(body, &leaderboard); err != nil {
		return nil, err
	}
	
	return leaderboard, nil
}

使用示例

func main() {
	client := NewPlaylyfeClient(
		"your_client_id",
		"your_client_secret",
		"https://your-redirect-uri.com/callback",
	)
	
	// 假设从OAuth回调获取了code
	err := client.GetAccessToken("authorization_code_from_callback")
	if err != nil {
		fmt.Println("Failed to get access token:", err)
		return
	}
	
	// 获取玩家信息
	player, err := client.GetPlayer("player123")
	if err != nil {
		fmt.Println("Failed to get player:", err)
		return
	}
	fmt.Printf("Player: %+v\n", player)
	
	// 更新分数
	err = client.UpdatePlayerScore("player123", "experience", 100)
	if err != nil {
		fmt.Println("Failed to update score:", err)
		return
	}
	
	// 获取排行榜
	leaderboard, err := client.GetLeaderboard("top_players")
	if err != nil {
		fmt.Println("Failed to get leaderboard:", err)
		return
	}
	fmt.Printf("Leaderboard: %+v\n", leaderboard)
}

最佳实践

1. 令牌管理: 实现令牌自动刷新机制
2. 错误处理: 完善各种API错误的处理
3. 并发控制: 在高并发场景下使用连接池
4. 日志记录: 记录API请求和响应
5. 重试机制: 对临时性错误实现自动重试

以上代码提供了Playlyfe REST API的基本集成方法，你可以根据实际需求扩展更多功能。