buddhism/api/activity

活动API文档

概述

活动API提供了寺庙活动相关的所有接口，包括活动列表、详情、报名等功能。

接口列表

1. 获取活动列表

接口地址： GET /app/activitie/list

请求参数：

参数名	类型	必填	说明
templeId	string	否	寺庙ID
status	string	否	活动状态
pageNum	number	否	页码，默认1
pageSize	number	否	每页数量，默认20

响应示例：

{
  "msg": "操作成功",
  "code": 200,
  "data": [
    {
      "id": "1",
      "templeId": "12",
      "title": "初一祈福",
      "imgUrl": "https://api.ccttiot.com/image.jpg",
      "content": "活动主题: 初一祈福,诸事圆满,心生欢喜",
      "actStartTime": "2025-08-13 00:00:00",
      "actEndTime": "2025-09-16 00:00:00",
      "status": "1",
      "address": "福建省宁德市福鼎市太姥山镇",
      "phone": "13800138000",
      "attendance": 100,
      "readNum": 500,
      "type": "1",
      "currentBooking": 50
    }
  ]
}

2. 获取活动详情

接口地址： GET /app/activitie/detail/{id}

路径参数：

参数名	类型	必填	说明
id	string	是	活动ID

响应示例：

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "id": "1",
    "templeId": "12",
    "title": "初一祈福",
    "imgUrl": "https://api.ccttiot.com/image.jpg",
    "content": "活动详细内容...",
    "actStartTime": "2025-08-13 00:00:00",
    "actEndTime": "2025-09-16 00:00:00",
    "status": "1",
    "address": "福建省宁德市福鼎市太姥山镇",
    "phone": "13800138000",
    "attendance": 100,
    "readNum": 500,
    "type": "1",
    "currentBooking": 50
  }
}

3. 报名活动

接口地址： POST /app/activitie/register

请求参数：

参数名	类型	必填	说明
activityId	string	是	活动ID
userId	string	是	用户ID
userName	string	是	用户姓名
phone	string	是	联系电话

响应示例：

{
  "msg": "报名成功",
  "code": 200,
  "data": {
    "registrationId": "123",
    "activityId": "1",
    "userId": "456",
    "status": "success"
  }
}

4. 取消报名

接口地址： POST /app/activitie/cancel/{id}

路径参数：

参数名	类型	必填	说明
id	string	是	报名记录ID

响应示例：

{
  "msg": "取消成功",
  "code": 200,
  "data": null
}

5. 获取我的报名记录

接口地址： GET /app/activitie/my-registrations

请求参数：

参数名	类型	必填	说明
pageNum	number	否	页码，默认1
pageSize	number	否	每页数量，默认20

响应示例：

{
  "msg": "操作成功",
  "code": 200,
  "data": [
    {
      "id": "123",
      "activityId": "1",
      "activityTitle": "初一祈福",
      "registrationTime": "2025-08-10 10:00:00",
      "status": "confirmed"
    }
  ]
}

数据字段说明

活动状态 (status)

值	说明
"0"	已结束
"1"	报名中
"2"	进行中
"3"	已结束

活动类型 (type)

值	说明
"1"	祈福活动
"2"	法会活动
"3"	禅修活动
"4"	捐赠活动
"5"	义工活动

使用示例

import activityApi from '@/api/activity/activity.js'

// 获取活动列表
const getActivities = async () => {
  try {
    const response = await activityApi.getActivityList({
      pageNum: 1,
      pageSize: 20,
    })

    if (response.code === 200) {
      console.log('活动列表:', response.data)
    }
  } catch (error) {
    console.error('获取活动列表失败:', error)
  }
}

// 报名活动
const registerActivity = async (activityId, userInfo) => {
  try {
    const response = await activityApi.registerActivity({
      activityId,
      userId: userInfo.id,
      userName: userInfo.userName,
      phone: userInfo.phone,
    })

    if (response.code === 200) {
      console.log('报名成功')
    }
  } catch (error) {
    console.error('报名失败:', error)
  }
}

错误处理

所有接口都会返回统一的错误格式：

{
  "msg": "错误信息",
  "code": 错误码,
  "data": null
}

常见错误码：

错误码	说明
200	成功
400	请求参数错误
401	未授权，需要登录
403	权限不足
404	资源不存在
500	服务器内部错误

注意事项

1. 所有接口都需要在请求头中携带有效的token（除了登录相关接口）
2. 活动列表支持分页查询，建议每页不超过50条
3. 报名活动前需要确保用户已登录
4. 活动状态会根据时间自动更新
5. 图片URL为完整路径，可直接使用