用户服务接口文档 v1.0

基础信息

接口列表

1. 创建/获取用户

POST
/create_or_get_user.php

请求参数

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

响应示例

{
    "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"
    }
}

状态码说明

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

数据库结构

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,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

安全要求