first commit

.gitignore

@@ -0,0 +1,5 @@
+# misc
+.DS_Store
+.vscode/
+.idea/
+*.swp

接口规范.md

@@ -0,0 +1,70 @@
+#### 通用请求
+
+```json
+{
+  "key_xx": "value_xx「任意类型值」",
+  "key_yy": "value_yy「任意类型值」"
+}
+```
+
+#### 通用正确返回
+
+```json
+{
+  "code": 200,
+  "data": "result_「任意类型值」",
+  "message": "success"
+}
+```
+
+#### 通用错误返回
+
+```json
+{
+  // 错误码，跟 http-status 一致，并且在 grpc 中可以转换成 grpc-status
+  "code": 500,
+  // 错误原因，定义为业务判定错误码
+  "reason": "USER_NOT_FOUND",
+  // 错误信息，为用户可读的信息，可作为用户提示内容
+  "message": "invalid argument error"
+}
+```
+
+#### 列表请求
+
+```json
+{
+  "page": 1,
+  "per_page": 10,
+  "key_xx": "value_xx「任意类型值」"
+}
+```
+
+#### 列表返回
+
+```json
+{
+  "code": 200,
+  "data": {
+    "page": 1,
+    "per_page": 10,
+    "total": 1000,
+    "list": ["xxx「任意类型值」"]
+  },
+  "message": "success"
+}
+```
+
+------
+
+#### 高级检索value格式
+
+```json
+[
+  {
+    "operator":"AND",
+    "field":"name",
+    "value":["value_xxx"]
+  }
+]
+```