如何用不基于实体api平台的资源创建API？

Question

我需要创建一个GETendpoint来返回通过超文本传输协议客户端从另一个应用程序获取的资源，而不是基于实体。我获取的资源是一个数组：

[
    "id" => 1234
    "first_name" => ""
    "last_name" => ""
    "email" => ""
    "country" => 1
    "country_code" => 93
    "phone_number" => "3434343"
    "nationality" => "AF"
    "professional_industry" => "Health Care"
    "job_title" => "Medical Doctor - General Practitioner"
    "specialisation" => "No specialisation"
    "career_length_month" => 1
    "career_length_year" => 1
  ]

然后我需要查询数据库以获取一些数据以添加到资源数组中。

所以我在src/控制器/MyController.php中创建了它：

    /**
     * @Route("/api/v1/get-profile", name="get_profile")
     * @return JsonResponse
     */
    public function getMemberInfo(): JsonResponse
    {
        // step 1 : use http client to request data from another application
        // step 2 : query DB to fetch some data and add to data array
        return new JsonResponse($data, Response::HTTP_OK);
    }

但是现在，我希望我的api返回json api响应格式：https://jsonapi.org/.

基于实体的资源，api平台完全支持。我不需要做太多。我只是在实体类中添加“key”#[Api资源]并配置一些东西。然后我有一个json api格式的api，很容易：

{
    "data": {
        "id": "",
        "type": "",
        "attributes": {}
    }
}

但是如果资源不是基于实体的呢？是否有任何api平台的内置功能我可以使用，或者我必须自己做一个转换器？

Answer 1

最好是可以创建自定义数据提供程序。此自定义数据提供程序将负责从外部源提取数据。然后，API平台将能够像常规实体一样使用它。

• 文档
• API 平台演示中的完整示例

Answer 2

您需要重写OpenAPI规范如何在留档中描述：https://api-platform.com/docs/core/openapi/#overriding-the-openapi-specification

然后，在新的类中，您必须添加您需要的模式定义，添加新的PathItem实例，每个PathItem需要新的操作实例，等等。

很抱歉没有粘贴示例，它需要这么多代码。我在一个项目中以这种方式工作，但目前还不公开。

我希望我能阻止你。