README

$ composer require jncinet/qihucms-present

使用说明

数据迁移

$ php artisan migrate

发布资源

$ php artisan vendor:publish --provider="Qihucms\Present\PresentServiceProvider"

后台菜单

• 礼物列表 present/presents
• 礼物订单 present/orders

路由参数说明

礼物列表

route('api.present.index')
请求：GET
地址：/present/presents?pay_type_id={$pay_type_id}&...&page={$page}&limit={$limit}
参数：
int          $pay_type_id      （选填）支付货币类型
int          $exchange_type_id （选填）兑换货币类型
string       $name             （选填）根据礼物名模糊查询
int          $page             （选填）页码
int          $limit            （选填）每页显示的条数
返回值：
{
    data: [
        {
            id：礼物ID
            name：礼物名字
            thumbnail：礼物小图
            image：礼物大图
            animation：动画
            pay_currency_type：付款币类型
            pay_amount：付款数额
            unit: 礼物计数单位,
        },
        ...
    ],
    meta: {},
    links: {}
}

礼物订单列表

route('api.present.order')
请求：GET
地址：/present/orders?user_id={$user_id}&...&page={$page}&limit={$limit}
参数：
int          $user_id          （选填）送礼物会员ID
int          $to_user_id       （选填）收礼物会员ID
int          $present_id       （选填）礼物ID
0|1          $type             （选填）送出的礼物0、收到的礼物1
0|1|2        $status           （选填）礼物订单状态0失败订单，1成功订单，2异常订单
int          $page             （选填）页码
int          $limit            （选填）每页显示的条数
返回值：
{
    data: [
        {
            id：礼物ID
            present：{礼物信息}
            to_user：{收礼会员信息}  // 参数type为0时存在
            to_user_id：收礼会员ID  // 参数type为1时存在
            user：{送礼会员信息}    // 参数type为1时存在
            user_id：送礼会员ID    // 参数type为0时存在
            status：订单状态
            created_at：创建时间
            updated_at: 更新时间,
        },
        ...
    ],
    meta: {},
    links: {}
}

送礼物

route('api.present.givings')
请求：POST
地址：/present/givings
参数：
int $present_id （必填）礼物ID
int $to_user_id （必填）收礼会员ID
返回值：
{
    status: 'SUCCESS',
    result: {
        to_user_id: 礼物ID
        present_id：收礼会员ID
    }
}

事件调用

// 创建订单
Qihucms\Present\Events\GivingPresent

数据库

礼物表：presents

礼物订单表：present_orders