Perfect JSON API 示例 English

一个Perfect JSON API示例

该项目通过SPM软件包管理器编译，是Perfect项目之一
请确保您已经安装了Xcode 8.0或更高版本。

准备工作 - 使用Xcode 8

swift package generate-xcodeproj

打开 Perfect-JSON-API.xcodeproj
在"Project Settings"下的"Library Search Paths"中添加$(PROJECT_DIR)递归. (这一步将不需要在更高版本的Xcode 8中做)
在Xcode的构建目标下拉来选择可执行文件
在Xcode中使用(cmd-R)命令来编译运行项目工程

您将会在Xcode控制台看到如下输出:

[INFO] Starting HTTP server on 0.0.0.0:8181 with document root ./webroot

您将会看到如下输出:

[INFO] Starting HTTP server on 0.0.0.0:8181 with document root ./webroot

此API中包含下列演示路由:

GET: http://localhost:8181/ - 一个返回显示"Hello, world!"的HTML页面。
GET: http://localhost:8181/api/v1/people - 从模拟数据返回JSON形式的persons列表。
POST: http://localhost:8181/api/v1/people - 将一个person添加到内部模拟对象并返回一个JSON形式的数组. 请注意需要下列参数: firstName, lastName, email.
POST: http://localhost:8181/api/v1/people/json - 接受原本的JSON, 添加一个新的person, 返回一个新的列表. JSON是下面的格式:

{
    "email": "test@example.com",
    "firstName": "Test",
    "lastName": "User"
}

文件夹包含了一个Postman的URL集合的Example-WeatherAPI.postman_collection文件

如果已经安装了Postman,就可以导入文件并轻松使用请求路由

目前我们已经把所有错误报告合并转移到了JIRA上，因此github原有的错误汇报功能不能用于本项目。

您的任何宝贵建意见或建议，或者发现我们的程序有问题，欢迎您在这里告诉我们。http://jira.perfect.org:8080/servicedesk/customer/portal/1。