API 资源

未匹配的标注

用 API 资源

所有 API 返回的数据, 必须 使用 Laravel 自带的 API 资源 进行返回。

业务逻辑

绝不 在 API 资源中写业务逻辑。在 Service 层封装逻辑,输出数据,Resource 层只做定制。

所有读取逻辑,皆可封装到 Service 层或者 Model 层,不应该出现在 API Resources 层。

API Resources 层只负责确保返回数据格式。以及确保 API 返回结构的可溯性。

显性

API Resources 必须使用显性的数据结构,而非隐性。

❌ 隐性:

<?php

namespace App\Resources;

use Illuminate\Http\Resources\Json\JsonResource;

class AssetRateResource extends JsonResource
{
    public function toArray($request): array
    {
        return $this->resource->toArray();
    }
}

✅ 显性:

<?php

namespace App\Resources;

use Illuminate\Http\Resources\Json\JsonResource;

class AssetRateResource extends JsonResource
{
    public function toArray($request): array
    {
        return [
            // 把所需字段一个个列出来
            'asset_uuid' => $this->resource->asset_uuid,
            'rate'    => $this->resource->rate,
        ];
    }
}

返回数据格式

蛇形命名法(snake case) 还是 驼峰命名法(camel case)?

所有返回数据 必须 使用 蛇形命名法。接受请求的数据,也 必须 使用蛇形命名法。

❌ 驼峰:

{
    "userType": "robot",
    "avatarUrls": [
        "https://cdn.image.com/r9Z7phw4sFWwi-7YVqSiXuLo0wzMJk9asCrUFA=s256"
    ]
}

✅ 蛇形:

{
    "user_type": "robot",
    "avatar_urls": [
        "https://cdn.image.com/r9Z7phw4sFWwi-7YVqSiXuLo0wzMJk9asCrUFA=s256"
    ]
}

参考 GitHub 的 API 设计:

前端如需使用驼峰命名,可使用 domchristie/humps 包对请求和结果的数据进行转换。

本文章首发在 LearnKu.com 网站上。

上一篇 下一篇
《L04 微信小程序从零到发布》
从小程序个人账户申请开始,带你一步步进行开发一个微信小程序,直到提交微信控制台上线发布。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
贡献者:1