avertys/json-api-response

从您的API发送优雅的JSON响应。

v1.0.1 2022-08-19 12:44 UTC

This package is not auto-updated.

Last update: 2024-09-28 21:18:35 UTC


README

Latest Version on Packagist Total Downloads GitHub Actions

此包允许您从Laravel API发送优雅的JSON响应。

安装

您可以通过composer安装此包

composer require avertys/json-api-response

使用方法

成功的响应

  return JsonApiResponse::make($data)
        ->withSuccess()
        ->send(200);

添加附加数据

  return JsonApiResponse::make($data)
        ->withSuccess()
        ->withAdditionalData([
            'deprecated' => true
        ])
        ->send(200);

失败的响应

  return JsonApiResponse::make()
        ->withErrors($validator->errors())
        ->withAdditionalData([
            'deprecated' => true
        ])
        ->send(200);

与分页一起工作

  return JsonApiResponse::make(User::paginate(10))
        ->withSuccess()
        ->send(200);

响应格式

{
    "success": true,
    "data": [
        "id": 1,
        "name": "John" 
    ],
    "errors": null,
    "additional_data": [
        "pagination": {
            "current_page": 2,
            "to": 5,
            "total": 100
        },
        "deprecated": false
    ]
}

变更日志

请参阅 CHANGELOG 了解最近更改的详细信息。

贡献

请参阅 CONTRIBUTING 了解详细信息。

安全性

如果您发现任何安全相关的问题,请通过电子邮件 hoostr.co@gmail.com 而不是使用问题跟踪器来报告。

致谢

许可证

MIT许可证(MIT)。有关更多信息,请参阅 许可证文件

Laravel Package Boilerplate

此包是用 Laravel Package Boilerplate 生成的。