用户服务接口文档 v1.1

基础信息

接口列表

1. 创建/获取用户

POST
/create_or_get_user.php

请求参数

字段类型必填说明
openidstring第三方平台用户唯一标识
avatarstring头像URL地址
nicknamestring用户昵称(需URL编码)

响应示例

{
    "status": 200,
    "message": "用户已存在",
    "data": {
        "id": 123
    }
}

2. 获取用户信息

GET
/get_user.php

请求参数

参数类型必填说明
idint用户唯一ID

响应示例

{
    "status": 200,
    "message": "获取成功",
    "data": {
        "id": 123,
        "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
        "avatar": "https://avatar.url",
        "nickname": "张三",
        "created_at": "2023-08-20 14:30:00"
    }
}

3. 添加游戏记录

POST
/add_game_record.php

请求参数

字段类型必填说明
user_idint用户ID
scorefloat游戏分数
pointsint获得积分

响应示例

{
    "status": 201,
    "message": "记录添加成功",
    "data": {
        "record_id": 456,
        "user_id": 123,
        "total_points": 1500
    }
}

数据库结构

用户表 (users)

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    openid VARCHAR(255) UNIQUE NOT NULL,
    avatar VARCHAR(255) NOT NULL,
    nickname VARCHAR(255) NOT NULL,
    total_points INT DEFAULT 0,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

游戏记录表 (game_records)

CREATE TABLE game_records (
    id INT AUTO_INCREMENT PRIMARY KEY,
    user_id INT NOT NULL,
    score DECIMAL(10,2) NOT NULL,
    points INT NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (user_id) REFERENCES users(id)
);

状态码说明

状态码说明
200成功
201资源创建成功
400参数错误
404资源不存在
500服务器错误

安全要求