BusinessBookingAPI

An API that allows you to manage Bookings, Businesses, Hours and Services.

原始信息汇总

BusinessBookingAPI 数据集概述

基本信息

• API名称: BusinessBookingAPI
• 提供商: vferreira19
• 类别: Business Software
• 基础URL: https://businessbookingapi.up.railway.app/api
• 认证方式: JWT Bearer Token（有效期8小时）
• API类型: RESTful API

功能描述

Business Booking API 是一个面向开发者的强大解决方案，旨在以最小的工作量将完整的预订管理集成到任何应用程序中。它专为希望专注于构建优秀前端而无需担心预订逻辑复杂性的开发者而设计。该API处理从企业管理、服务定义到实时可用性检查和预订创建的所有事务。

核心功能

• 在单个API密钥下创建和管理多个企业。
• 定义具有自定义价格和持续时间的服务。
• 设置企业营业时间和可用性。
• 创建、确认和取消预订。
• 通过内置的重叠检测防止重复预订。
• 通过基于角色的访问控制管理客户和企业所有者。

适用场景

适用于为美甲店、健身房、沙龙或任何其他服务型企业构建预订系统。

订阅计划与限制

计划	月费	每月请求限制
Basic (免费)	$0.00	100
Pro	$5.00	10,000
Ultra	$10.00	50,000
Mega	$20.00	500,000

主要端点

账户 (Account)

• POST /api/Account/Login: 认证并获取JWT令牌。
• POST /api/Account/Register: 为企业注册新客户（BusinessOwner角色）。
• POST /api/Account/RegisterOwner: 注册新企业所有者（Developer角色）。
• POST /api/Account/RegisterDeveloper: 注册新开发者账户（仅Admin角色）。

企业 (Business)

• GET /api/Business: 获取认证开发者的所有企业（Developer角色）。
• GET /api/Business/{id}: 按ID获取企业（Developer, BusinessOwner角色）。
• POST /api/Business: 创建新企业（Developer角色）。

营业时间 (Business Hours)

• GET /api/Business/hours/{businessId}: 获取企业的营业时间（BusinessOwner角色）。
• POST /api/Business/hours: 设置某一天的营业时间（BusinessOwner角色）。

服务 (Services)

• GET /api/Services: 获取所有服务（BusinessOwner, User角色）。
• GET /api/Services/{id}: 按ID获取服务（BusinessOwner, User角色）。
• POST /api/Services: 创建新服务（BusinessOwner角色）。

预订 (Bookings)

• GET /api/Booking: 获取所有预订（BusinessOwner, User角色）。
• GET /api/Booking/{id}: 按ID获取预订（BusinessOwner, User角色）。
• POST /api/Booking: 创建新预订（User角色）。
• PUT /api/Booking/{id}/Confirm: 确认预订（BusinessOwner角色）。
• PUT /api/Booking/{id}/Cancel: 取消预订（BusinessOwner, User角色）。
• GET /api/Booking/{id}/status: 获取预订状态（BusinessOwner, User角色）。

类别 (Categories)

• GET /api/Categories: 获取所有类别（所有角色）。
• GET /api/Categories/{id}: 按ID获取类别（所有角色）。
• POST /api/Categories: 创建新类别（Developer角色）。

角色系统

角色	描述
Developer	顶级账户。在入职期间创建。管理企业和类别。
BusinessOwner	管理特定企业。由开发者创建。管理营业时间、服务、预订并注册客户。
User	终端客户。由企业所有者创建。可以创建和管理自己的预订。
Admin	仅供内部使用。可以创建开发者账户。

错误处理

API返回标准的HTTP状态码：

• 200: 成功
• 201: 已创建
• 400: 请求错误 — 验证失败
• 401: 未授权 — 令牌缺失或无效
• 403: 禁止访问 — 角色权限不足
• 404: 未找到 — 资源不存在
• 500: 内部服务器错误

获取访问权限流程

1. 在 RapidAPI 上订阅计划。
2. 通过 RapidAPI 讨论板联系提供商并提供您的电子邮件地址。
3. 提供商将创建您的开发者账户并向您发送凭据。
4. 使用 /api/Account/Login 端点登录以接收您的 JWT 令牌。