points.js 2.06 KB
/*
 * @Date: 2023-12-22 10:29:37
 * @LastEditors: hookehuyr hookehuyr@gmail.com
 * @LastEditTime: 2025-09-03 18:10:03
 * @FilePath: /lls_program/src/api/points.js
 * @Description: 文件描述
 */
import { fn, fetch } from './fn';

const Api = {
  SYNC_WX_STEP: '/srv/?a=point&t=sync_wx_step',
  COLLECT_POINT: '/srv/?a=point&t=collect',
  POINT_LIST: '/srv/?f=walk&a=point&t=list',
}

/**
 * @description: 同步微信步数
 * @returns
 */
export const syncWxStepAPI = (params) => fn(fetch.post(Api.SYNC_WX_STEP, params));

/**
 * @description: 汇总积分到家庭
 * @param {*} params
 * @param {string} params.family_id - 家庭ID
 * @param {string} params.point_id - 积分ID, 为空时用于一键全积
 * @returns {Object} response - 响应对象
 * @returns {string} response.code - 响应状态码
 * @returns {string} response.msg - 响应消息
 * @returns {Object} response.data - 响应数据
 * @returns {number} response.data.new_total_points - 最新的家庭积分
 */

export const collectPointAPI = (params) => fn(fetch.post(Api.COLLECT_POINT, params));

/**
 * @description: 查询积分列表
 * @param {Object} params - 请求参数
 * @param {string} [params.page] - 页码,从0开始,默认为0
 * @param {string} [params.limit] - 每页数量,默认为10
 * @returns {Object} response - 响应对象
 * @returns {number} response.code - 响应状态码
 * @returns {string} response.msg - 响应消息
 * @returns {Object} response.data - 响应数据
 * @returns {number} response.data.total_points - 我的积分
 * @returns {Array} response.data.logs - 积分日志列表
 * @returns {number} response.data.logs[].id - 积分日志ID
 * @returns {string} response.data.logs[].points_change - 积分变化
 * @returns {string} response.data.logs[].balance_after - 最新的家庭积分
 * @returns {string} response.data.logs[].log_type - 日志类型
 * @returns {string} response.data.logs[].source_type - 积分来源类型
 * @returns {string} response.data.logs[].note - 备注
 */
export const getPointListAPI = (params) => fn(fetch.get(Api.POINT_LIST, params));