README

Laravel 4.2 的基于 API 的可用性日历

需要 Carbon\Carbon，但 Laravel 4.2 已提供

安装

composer require anzware/avail

avail 模式

运行 php artisan migrate --package="anzware/avail"

avail_calendars

$table->bigIncrements('calendar_id');
$table->string('calendar_name', 255);
$table->string('status', 15);
$table->timestamps();

avail_bookings

$table->bigIncrements('booking_id');
$table->bigInteger('calendar_id');
$table->date('calendar_date');
$table->bigInteger('state_id');
// external_booking_ids could be integer or string depending on external id data type
// assuming string as data type for good measure
$table->string('external_booking_id', 255)->nullable();
$table->timestamps();

使用 external_booking_id 来链接您的实际预订 ID

avail_states

$table->bigIncrements('state_id');
$table->string('state', 100);
$table->tinyInteger('state_order')->nullable()->default(0);
$table->timestamps();

APIs

获取带有数据的日历

GET /avail/api/get-calendar-with-data

参数

integer take (可选) - 需要显示的月份数量（默认：3）

integer page (可选) - 从当前月份开始的分页（默认：1）

integer calendar_id (必需) - 日历 ID

获取日历列表

GET /avail/api/get-calendar

参数

integer calendar_id (可选) - 日历 ID

获取状态列表

GET /avail/api/get-state

参数

integer state_id (可选) - 状态 ID

创建新的日历

POST /avail/api/post-new-calendar

参数

string name (必需) - 日历名称

string status (必需) - 日历状态 ('active', 'inactive')

更新现有日历

POST /avail/api/post-update-calendar

参数

integer calendar_id (必需) - 日历 ID

string name (可选) - 日历名称

string status (可选) - 日历状态 ('active', 'inactive')

创建新状态

POST /avail/api/post-new-state

参数

integer calendar_id (必需) - 日历 ID

string name (可选) - 日历名称

string status (可选) - 日历状态 ('active', 'inactive')

更新现有状态

POST /avail/api/post-update-state

参数

integer state_id (必需) - 状态 ID

string state (可选) - 状态名称

integer state_order (可选) - 状态顺序，用于显示目的

创建预订项

POST /avail/api/post-new-booking

参数

integer calendar_id (必需) - 日历 ID

integer state_id (必需) - 状态 ID

array dates (必需) - 选择日期

string external_booking_id (可选) - 外部预订 ID (您的实际预订详情 ID)

删除预订项

POST /avail/api/post-release-booking

参数

integer calendar_id (必需) - 日历 ID

array dates (必需) - 选择日期