0

我没有找到描述所有响应代码的方法，我只看到默认代码。我有很多回应，并想描述它们。我也有兴趣描述导致 400 响应错误的不同请求（例如，具有此类数据的请求将返回该消息等），是否应该在 API 文档中进行描述？

4

2 回答 2

0

如何在 Apigility 中自定义错误响应

Apigility 与ZF Api Problem无缝协作以进行错误处理。

从控制器或侦听器创建错误响应非常简单：

use ZF\ApiProblem\ApiProblem;

...

return new ApiProblem(500, "My Internal Server Error");

常见错误的状态标题在类中设置。

建议坚持使用适合所发生问题的有效http 错误代码，但您当然可以自定义标题。您可以ApiProblem直接从您的控制器和侦听器返回您的，Apigility将正确处理error并返回一个呈现的json响应，并将Content-Type标头设置为application/problem+json.

于 2015-02-24T09:03:03.637 回答
0

不确定这是否仍然存在，但您可以使用additionalApi 响应对象中的构造函数参数来自定义您的答案；

return new ApiProblem(
    Response::STATUS_CODE_500,
    'Internal Server Error',
    null,
    'This is the title',
    [
        'specific' => 'entry',
        'more_problem_details' => [
            'custom_code' => 'custom_code_value',
            'custom_message' => 'custom_message_text',
        ],
    ]
);

响应将如下所示：

{
    "specific": "entry",
    "more_problem_details": {
        "custom_code": "custom_code_value",
        "custom_message": "custom_message_text"
    },
    "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
    "title": "This is the title",
    "status": 500,
    "detail": "Internal Server Error"
}

检查此以获取更多详细信息：

https://docs.zendframework.com/zend-problem-details/response/

于 2018-11-29T08:59:30.347 回答