后端接口响应格式

专题/后端/2020.12.1后端接口格式.md

@@ -0,0 +1,81 @@
+> 正常响应
+
+```
+{
+    "version": "1.0.0.0",
+    "code": 200,
+    "message": "this is message",
+    "isError": false,
+    "data": {
+        "id": 1,
+        "name": "name",
+        "age": 21
+    }
+}
+```
+
+> 异常响应
+
+```
+{
+    "version": "1.0.0.0",
+    "code": 500,
+    "isError": true,
+    "responseException": {
+        "exceptionMessage": "Unhandled Exception occurred. Unable to process the request."
+    }
+}
+```
+
+> 入参字段不符合要求响应
+
+```
+{
+    "version": "1.0.0.0",
+    "code": 400,
+    "isError": true,
+    "responseException": {
+        "exceptionMessage": "Request responded with one or more validation errors occurred.",
+        "validationErrors": [
+            {
+                "name": "Name",
+                "reason": "最大长度5"
+            },
+            {
+                "name": "Location",
+                "reason": "最大长度5"
+            }
+        ]
+    }
+}
+```
+
+# code状态码一栏表
+
+状态码类型：
+
+- 1**：服务器收到，客户端继续操作
+- 2**：服务端处理成功
+- 3**：服务端重定向
+- 4**：客户端错误
+- 5**：服务端错误
+
+状态码：
+
+- 200：服务端确认客户端请求成功，一般用于GET和POST请求
+- 201：服务端创建资源成功
+- 204：服务端没有内容返回
+- 404：客户端要找的资源不存在
+- 412：客户端先决条件错误
+- 413：客户端请求实体过大
+- 414：客户端请求URL过长
+- 415：客户端媒体格式不对
+- 419：客户端身份验证超时
+- 422：客户端实体验证失败
+- 429：客户端请求过多
+- 431：客户端请求头过大
+- 500：服务端内部错误
+- 501：服务端不支持的请求
+- 502：服务端收到来自远端的无效响应
+- 503：服务端无法处理客户端请求
+- 505：服务端不支持请求的HTTP协议版本

专题/后端/2020.12.1后端接口格式实现.md

@@ -0,0 +1,119 @@
+> 正常响应
+
+```
+{
+    "version": "1.0.0.0",
+    "code": 200,
+    "message": "this is message",
+    "isError": false,
+    "data": {
+        "id": 1,
+        "name": "name",
+        "age": 21
+    }
+}
+
+================================
+
+使用ApiResponse构造函数返回正常响应。
+
+[Route("get1")]
+[HttpGet]
+public ApiResponse Get1()
+{
+
+    var data = new { Id = 1, Name = "name", Age = 21 };
+    return new ApiResponse("this is message", data, StatusCodes.Status200OK);
+
+}
+```
+
+> 异常响应
+
+```
+{
+    "version": "1.0.0.0",
+    "code": 500,
+    "isError": true,
+    "responseException": {
+        "exceptionMessage": "Unhandled Exception occurred. Unable to process the request."
+    }
+}
+
+================================
+
+在接口层throw抛出异常
+
+[Route("get1")]
+[HttpGet]
+public ApiResponse Get1()
+{
+    try
+    {
+
+        int i = 0;
+        int j = 5 / i;
+        return new ApiResponse("New record has been created in the database", 1, StatusCodes.Status201Created);
+    }
+    catch (Exception ex)
+    {
+
+        throw;
+    }
+
+}
+
+==============================
+
+使用ApiException抛出特定类型的异常。
+
+[HttpGet]
+[Route("get2")]
+public ApiResponse Get2()
+{
+    throw new ApiException("doesnt exist", StatusCodes.Status404NotFound);
+}
+```
+
+> 入参字段不符合要求响应
+
+```
+{
+    "version": "1.0.0.0",
+    "code": 400,
+    "isError": true,
+    "responseException": {
+        "exceptionMessage": "Request responded with one or more validation errors occurred.",
+        "validationErrors": [
+            {
+                "name": "Name",
+                "reason": "最大长度5"
+            },
+            {
+                "name": "Location",
+                "reason": "最大长度5"
+            }
+        ]
+    }
+}
+
+================================
+
+使用ApiException抛模型错误异常。
+
+[HttpPost]
+[Route("customException")]
+public ApiResponse Post1(AutoWrapperDemo model)
+{
+    if(!ModelState.IsValid)
+    {
+        throw new ApiException(ModelState.AllErrors());
+    }
+    return new ApiResponse("New record has been created in the database", 1, StatusCodes.Status201Created);
+}
+
+
+```
+
+
+

团队/2020.11.26大家来说.md → 团队/2020.11.26迎合取悦与信息量.md

@@ -1,4 +1,13 @@
-# 为什么
+
+# 迎合取悦与信息量
+
+一个真实的故事。
+
+# 流程和流程的弹性
+
+沟通的点和频率。
+
+# 问题域和解决域
 
 某种程度上，我们的日常工作就是解决问题的过程。而我们发现，什么是需要解决的问题，以及解决问题的方式方法因人而异，并且没有绝对正确答案。