2.11. 请求你的 API

未匹配的标注

使用 Postman

向您的API发出请求非常简单。最好的办法就是使用类似 Postman 的工具。

因为我们不是在URL里面对API进行版本控制,所以我们需要定义一个 Accept 头信息来请求我们的特定版本。header 的格式是这样的:

Accept: application/vnd.YOUR_SUBTYPE.v1+json

在上面的事例中,您将替换 YOUR_SUBTYPE 为您在配置中定义的子类型名称。同样,这通常是您运用程序中独特的东西,例如:它的名称和标识符,通常都是小写字母。

请记住,如果您使用的是不同的标准,例如 x, 那么您最好替换xvnd

在子类型名称之后,我们有我们想要的版本。在上面的例子中, 我们定义v1为我们的API 。然后是一个加号和所需要的格式。如果格式无效,软件包将尝试使用您在配置定义的默认格式。

使用 CURL

如果您不想使用 Postman 。 您可以使用命令行工具, 例如 Curl

$ curl -v -H "Accept: application/vnd.YOUR_SUBTYPE.v1+json" http://example.app/users

如果您启用了严格模式,并且传递无效的 Accept 头信息 。 Symfony\Component\HttpKernel\Exception\BadRequestHttpException 将抛出异常。

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

本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。

原文地址:https://learnku.com/docs/dingo-api/2.0.0...

译文地址:https://learnku.com/docs/dingo-api/2.0.0...

上一篇 下一篇
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
贡献者:3