diff --git a/docs/en/14-reference/02-rest-api/02-rest-api.mdx b/docs/en/14-reference/02-rest-api/02-rest-api.mdx
index 1691b8be8b53480199898ab4ec6b5917eba7979f..409e079b92d5c8375ce6b3da60c0b2aa053ef662 100644
--- a/docs/en/14-reference/02-rest-api/02-rest-api.mdx
+++ b/docs/en/14-reference/02-rest-api/02-rest-api.mdx
@@ -382,6 +382,130 @@ Response body:
   }
   ```
 
+## REST API between TDengine 2.x and 3.0
+
+### URI
+
+| URI                  | TDengine 2.x         | TDengine 3.0                                         |
+| :--------------------| :------------------: | :--------------------------------------------------: |
+| /rest/sql            | Supported            | Supported (with different response code and body)    |
+| /rest/sqlt           | Supported            | No more supported                                    |
+| /rest/sqlutc         | Supported            | No more supported                                    |
+
+### HTTP code
+
+| HTTP code            | TDengine 2.x         | TDengine 3.0 | note                                  |
+| :--------------------| :------------------: | :----------: | :-----------------------------------: |
+| 200                  | Supported            | Supported    | Success or taosc return error         |
+| 400                  | Not supported        | Supported    | Parameter error                       |
+| 401                  | Not supported        | Supported    | Authentication failure                |
+| 404                  | Supported            | Supported    | URI not exist                         |
+| 500                  | Not supported        | Supported    | Internal error                        |
+| 503                  | Supported            | Supported    | Insufficient system resources         |
+
+### Response body
+
+#### REST response body return from TDengine 2.x
+
+```JSON
+{
+  "status": "succ",
+  "head": [
+    "name",
+    "created_time",
+    "ntables",
+    "vgroups",
+    "replica",
+    "quorum",
+    "days",
+    "keep1,keep2,keep(D)",
+    "cache(MB)",
+    "blocks",
+    "minrows",
+    "maxrows",
+    "wallevel",
+    "fsync",
+    "comp",
+    "precision",
+    "status"
+  ],
+  "data": [
+    [
+      "log",
+      "2020-09-02 17:23:00.039",
+      4,
+      1,
+      1,
+      1,
+      10,
+      "30,30,30",
+      1,
+      3,
+      100,
+      4096,
+      1,
+      3000,
+      2,
+      "us",
+      "ready"
+    ]
+  ],
+  "rows": 1
+}
+```
+```
+  "data": [
+        [
+            "information_schema",
+            16,
+            "ready"
+        ],
+        [
+            "performance_schema",
+            9,
+            "ready"
+        ]
+    ],
+```
+
+#### REST response body return from TDengine 3.0
+
+```JSON
+{
+    "code": 0,
+    "column_meta": [
+        [
+            "name",
+            "VARCHAR",
+            64
+        ],
+        [
+            "ntables",
+            "BIGINT",
+            8
+        ],
+        [
+            "status",
+            "VARCHAR",
+            10
+        ]
+    ],
+    "data": [
+        [
+            "information_schema",
+            16,
+            "ready"
+        ],
+        [
+            "performance_schema",
+            9,
+            "ready"
+        ]
+    ],
+    "rows": 2
+}
+```
+
 ## Reference
 
 [taosAdapter](/reference/taosadapter/)
diff --git a/docs/zh/08-connector/02-rest-api.mdx b/docs/zh/08-connector/02-rest-api.mdx
index a081595bca5f66bff3c60808126516633f92614b..f3f1e087d809b7ce98d27721ada13b7a5fdf7159 100644
--- a/docs/zh/08-connector/02-rest-api.mdx
+++ b/docs/zh/08-connector/02-rest-api.mdx
@@ -383,6 +383,133 @@ curl http://192.168.0.1:6041/rest/login/root/taosdata
   }
   ```
 
+## TDengine 2.x 和 3.0 之间 REST API 的差异
+
+### URI
+
+| URI                  | TDengine 2.x         | TDengine 3.0                                         |
+| :--------------------| :------------------: | :--------------------------------------------------: |
+| /rest/sql            | 支持                 | 支持 （响应代码和消息体不同）                        |
+| /rest/sqlt           | 支持                 | 不再支持                                             |
+| /rest/sqlutc         | 支持                 | 不再支持                                             |
+
+
+### HTTP code
+
+| HTTP code            | TDengine 2.x         | TDengine 3.0 | 备注                                  |
+| :--------------------| :------------------: | :----------: | :-----------------------------------: |
+| 200                  | 支持                 | 支持         | 正确返回和 taosc 接口错误返回         |
+| 400                  | 不支持               | 支持         | 参数错误返回                          |
+| 401                  | 不支持               | 支持         | 鉴权失败                              |
+| 404                  | 支持                 | 支持         | 接口不存在                            |
+| 500                  | 不支持               | 支持         | 内部错误                              |
+| 503                  | 支持                 | 支持         | 系统资源不足                          |
+
+
+### 响应代码和消息体
+
+#### TDengine 2.x 响应代码和消息体
+
+```JSON
+{
+  "status": "succ",
+  "head": [
+    "name",
+    "created_time",
+    "ntables",
+    "vgroups",
+    "replica",
+    "quorum",
+    "days",
+    "keep1,keep2,keep(D)",
+    "cache(MB)",
+    "blocks",
+    "minrows",
+    "maxrows",
+    "wallevel",
+    "fsync",
+    "comp",
+    "precision",
+    "status"
+  ],
+  "data": [
+    [
+      "log",
+      "2020-09-02 17:23:00.039",
+      4,
+      1,
+      1,
+      1,
+      10,
+      "30,30,30",
+      1,
+      3,
+      100,
+      4096,
+      1,
+      3000,
+      2,
+      "us",
+      "ready"
+    ]
+  ],
+  "rows": 1
+}
+```
+```
+  "data": [
+        [
+            "information_schema",
+            16,
+            "ready"
+        ],
+        [
+            "performance_schema",
+            9,
+            "ready"
+        ]
+    ],
+```
+
+#### TDengine 3.0 响应代码和消息体
+
+
+```JSON
+{
+    "code": 0,
+    "column_meta": [
+        [
+            "name",
+            "VARCHAR",
+            64
+        ],
+        [
+            "ntables",
+            "BIGINT",
+            8
+        ],
+        [
+            "status",
+            "VARCHAR",
+            10
+        ]
+    ],
+    "data": [
+        [
+            "information_schema",
+            16,
+            "ready"
+        ],
+        [
+            "performance_schema",
+            9,
+            "ready"
+        ]
+    ],
+    "rows": 2
+}
+```
+
 ## 参考
 
 [taosAdapter](/reference/taosadapter/)