longportapp · huacnlee · May 20, 2024 · May 20, 2024
diff --git a/docs/api-reference/_category_.json b/docs/api-reference/_category_.json
@@ -0,0 +1,7 @@
+{
+  "position": 4.5,
+  "label": "API 附录",
+  "collapsible": true,
+  "collapsed": true,
+  "link": null
+}
diff --git a/docs/getting-developed/error-codes.md → docs/api-reference/error-codes.md b/docs/getting-developed/error-codes.md → docs/api-reference/error-codes.md
diff --git a/docs/getting-developed/how-to-access-api.md → docs/api-reference/how-to-access-api.md b/docs/getting-developed/how-to-access-api.md → docs/api-reference/how-to-access-api.md
@@ -1,11 +1,19 @@
 ---
-title: 如何调用 API
+title: Overview
 id: how-to-access-api
 slug: /how-to-access-api
 sidebar_position: 1
 ---
 
-## 开发前须知
+本部分内容主要介绍 LongPort OpenAPI 的基础信息，包括如何访问 API、如何使用 API、如何获取 API 接口文档等，内容比较原始。
+
+:::success 提示
+建议可以直接采用 SDK 的方式访问 API，SDK 已经封装了 API 的调用方式，使用起来更加方便。
+
+https://open.longportapp.com/sdk
+:::
+
+## API 须知
 
 | 注意事项                                     | 参考文档                                          |
 | -------------------------------------------- | ------------------------------------------------- |

diff --git a/docs/getting-developed/refresh-token-api.md → docs/api-reference/refresh-token-api.md b/docs/getting-developed/refresh-token-api.md → docs/api-reference/refresh-token-api.md
diff --git a/docs/socket/_category_.json → docs/api-reference/socket/_category_.json b/docs/socket/_category_.json → docs/api-reference/socket/_category_.json
@@ -2,6 +2,6 @@
   "position": 5,
   "label": "长连接",
   "collapsible": true,
-  "collapsed": false,
+  "collapsed": true,
   "link": null
 }
diff --git a/docs/socket/biz-command.md → docs/api-reference/socket/biz-command.md b/docs/socket/biz-command.md → docs/api-reference/socket/biz-command.md
diff --git a/docs/socket/control-command.md → docs/api-reference/socket/control-command.md b/docs/socket/control-command.md → docs/api-reference/socket/control-command.md
diff --git a/docs/socket/diff-ws-tcp.md → docs/api-reference/socket/diff-ws-tcp.md b/docs/socket/diff-ws-tcp.md → docs/api-reference/socket/diff-ws-tcp.md
diff --git a/docs/socket/hosts.md → docs/api-reference/socket/hosts.md b/docs/socket/hosts.md → docs/api-reference/socket/hosts.md
diff --git a/docs/socket/how_to_subscribe_quote.md → ...eference/socket/how_to_subscribe_quote.md b/docs/socket/how_to_subscribe_quote.md → ...eference/socket/how_to_subscribe_quote.md
diff --git a/docs/socket/how_to_subscribe_trade.md → ...eference/socket/how_to_subscribe_trade.md b/docs/socket/how_to_subscribe_trade.md → ...eference/socket/how_to_subscribe_trade.md
diff --git a/docs/socket/protocol/_category_.json → ...reference/socket/protocol/_category_.json b/docs/socket/protocol/_category_.json → ...reference/socket/protocol/_category_.json
@@ -2,6 +2,6 @@
   "position": 3,
   "label": "通信协议",
   "collapsible": true,
-  "collapsed": false,
+  "collapsed": true,
   "link": null
 }
diff --git a/docs/socket/protocol/connect.md → .../api-reference/socket/protocol/connect.md b/docs/socket/protocol/connect.md → .../api-reference/socket/protocol/connect.md
diff --git a/docs/socket/protocol/how-to-parse-header.md → ...ce/socket/protocol/how-to-parse-header.md b/docs/socket/protocol/how-to-parse-header.md → ...ce/socket/protocol/how-to-parse-header.md
diff --git a/docs/socket/protocol/how-to-parse-push.md → ...ence/socket/protocol/how-to-parse-push.md b/docs/socket/protocol/how-to-parse-push.md → ...ence/socket/protocol/how-to-parse-push.md
diff --git a/docs/socket/protocol/how-to-parse-request.md → ...e/socket/protocol/how-to-parse-request.md b/docs/socket/protocol/how-to-parse-request.md → ...e/socket/protocol/how-to-parse-request.md
diff --git a/.../socket/protocol/how-to-parse-response.md → .../socket/protocol/how-to-parse-response.md b/.../socket/protocol/how-to-parse-response.md → .../socket/protocol/how-to-parse-response.md
diff --git a/docs/socket/protocol/how_to_handshake.md → ...rence/socket/protocol/how_to_handshake.md b/docs/socket/protocol/how_to_handshake.md → ...rence/socket/protocol/how_to_handshake.md
diff --git a/docs/socket/protocol/protocol_overview.md → ...ence/socket/protocol/protocol_overview.md b/docs/socket/protocol/protocol_overview.md → ...ence/socket/protocol/protocol_overview.md
diff --git a/docs/socket/socket-otp-api.md → docs/api-reference/socket/socket-otp-api.md b/docs/socket/socket-otp-api.md → docs/api-reference/socket/socket-otp-api.md
diff --git a/docs/getting-developed/_category_.json b/docs/getting-developed/_category_.json
diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -1037,12 +1037,8 @@ SDK 的详细 API 文档请访问：
 
 ## 反馈及沟通
 
-- GitHub Issues: <https://github.com/longportapp/openapi-sdk/>
-
-- 微信沟通群（已满）：
-
-<img src="https://pub.lbkrs.com/files/202205/akTNrRTBrT5aMX4f/qrcode.jpg" className="max-w-2xl" />
-
-- 飞书沟通群：
-
-<img src="https://assets.lbkrs.com/uploads/2acb32b6-0718-4304-8d73-432a2d53aa97/feishu.png" className="max-w-2xl" />
+| 渠道               | 二维码 / 链接                                                                                  |
+| ------------------ | ---------------------------------------------------------------------------------------------- |
+| GitHub Issues      | <https://github.com/longportapp/openapi-sdk/issues>                                            |
+| 微信沟通群（已满） | <img src="https://pub.lbkrs.com/files/202205/akTNrRTBrT5aMX4f/qrcode.jpg" />                   |
+| 飞书沟通群         | <img src="https://assets.lbkrs.com/uploads/2acb32b6-0718-4304-8d73-432a2d53aa97/feishu.png" /> |
diff --git a/docs/quote/_category_.json b/docs/quote/_category_.json
@@ -1,7 +1,7 @@
 {
   "label": "行情",
   "collapsible": true,
-  "collapsed": true,
+  "collapsed": false,
   "link": null,
   "position": 3
 }
diff --git a/docs/socket/overview.md b/docs/socket/overview.md
diff --git a/docs/trade/_category_.json b/docs/trade/_category_.json
@@ -1,7 +1,7 @@
 {
   "label": "交易",
   "collapsible": true,
-  "collapsed": true,
+  "collapsed": false,
   "position": 4,
   "link": null
 }
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/api-reference/_category_.json b/i18n/en/docusaurus-plugin-content-docs/current/api-reference/_category_.json
@@ -0,0 +1,7 @@
+{
+  "position": 4.5,
+  "label": "API Reference",
+  "collapsible": true,
+  "collapsed": true,
+  "link": null
+}
diff --git a/.../current/getting-developed/error-codes.md → ...docs/current/api-reference/error-codes.md b/.../current/getting-developed/error-codes.md → ...docs/current/api-reference/error-codes.md
diff --git a/...nt/getting-developed/how-to-access-api.md → ...urrent/api-reference/how-to-access-api.md b/...nt/getting-developed/how-to-access-api.md → ...urrent/api-reference/how-to-access-api.md
@@ -1,11 +1,19 @@
 ---
-title: How to access an API
+title: Overview
 id: how-to-access-api
 slug: /how-to-access-api
 sidebar_position: 1
 ---
 
-## Pre-Development Notes
+This section mainly introduces the basic information of LongPort OpenAPI, including how to access the API, how to use the API, how to obtain the API interface document, etc., the content is relatively primitive.
+
+:::success Tip
+It is recommended to directly use the SDK to access the API, the SDK has encapsulated the API call method, which is more convenient to use.
+
+https://open.longportapp.com/sdk
+:::
+
+## Notes
 
 | Precautions                                                                                          | Reference Documents                                                             |
 | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |

diff --git a/...nt/getting-developed/refresh-token-api.md → ...urrent/api-reference/refresh-token-api.md b/...nt/getting-developed/refresh-token-api.md → ...urrent/api-reference/refresh-token-api.md
diff --git a/...ntent-docs/current/socket/_category_.json → ...rent/api-reference/socket/_category_.json b/...ntent-docs/current/socket/_category_.json → ...rent/api-reference/socket/_category_.json
diff --git a/...ontent-docs/current/socket/biz-command.md → ...rrent/api-reference/socket/biz-command.md b/...ontent-docs/current/socket/biz-command.md → ...rrent/api-reference/socket/biz-command.md
diff --git a/...nt-docs/current/socket/control-command.md → ...t/api-reference/socket/control-command.md b/...nt-docs/current/socket/control-command.md → ...t/api-reference/socket/control-command.md
diff --git a/...ontent-docs/current/socket/diff-ws-tcp.md → ...rrent/api-reference/socket/diff-ws-tcp.md b/...ontent-docs/current/socket/diff-ws-tcp.md → ...rrent/api-reference/socket/diff-ws-tcp.md
diff --git a/...ugin-content-docs/current/socket/hosts.md → ...ocs/current/api-reference/socket/hosts.md b/...ugin-content-docs/current/socket/hosts.md → ...ocs/current/api-reference/socket/hosts.md
diff --git a/.../current/socket/how_to_subscribe_quote.md → ...eference/socket/how_to_subscribe_quote.md b/.../current/socket/how_to_subscribe_quote.md → ...eference/socket/how_to_subscribe_quote.md
diff --git a/.../current/socket/how_to_subscribe_trade.md → ...eference/socket/how_to_subscribe_trade.md b/.../current/socket/how_to_subscribe_trade.md → ...eference/socket/how_to_subscribe_trade.md
diff --git a/...s/current/socket/protocol/_category_.json → ...reference/socket/protocol/_category_.json b/...s/current/socket/protocol/_category_.json → ...reference/socket/protocol/_category_.json
@@ -2,6 +2,6 @@
   "position": 3,
   "label": "Protocol",
   "collapsible": true,
-  "collapsed": false,
+  "collapsed": true,
   "link": null
 }
diff --git a/...t-docs/current/socket/protocol/connect.md → .../api-reference/socket/protocol/connect.md b/...t-docs/current/socket/protocol/connect.md → .../api-reference/socket/protocol/connect.md
diff --git a/...nt/socket/protocol/how-to-parse-header.md → ...ce/socket/protocol/how-to-parse-header.md b/...nt/socket/protocol/how-to-parse-header.md → ...ce/socket/protocol/how-to-parse-header.md
diff --git a/...rent/socket/protocol/how-to-parse-push.md → ...ence/socket/protocol/how-to-parse-push.md b/...rent/socket/protocol/how-to-parse-push.md → ...ence/socket/protocol/how-to-parse-push.md
diff --git a/...t/socket/protocol/how-to-parse-request.md → ...e/socket/protocol/how-to-parse-request.md b/...t/socket/protocol/how-to-parse-request.md → ...e/socket/protocol/how-to-parse-request.md
diff --git a/.../socket/protocol/how-to-parse-response.md → .../socket/protocol/how-to-parse-response.md b/.../socket/protocol/how-to-parse-response.md → .../socket/protocol/how-to-parse-response.md
diff --git a/...rrent/socket/protocol/how_to_handshake.md → ...rence/socket/protocol/how_to_handshake.md b/...rrent/socket/protocol/how_to_handshake.md → ...rence/socket/protocol/how_to_handshake.md
diff --git a/...rent/socket/protocol/protocol_overview.md → ...ence/socket/protocol/protocol_overview.md b/...rent/socket/protocol/protocol_overview.md → ...ence/socket/protocol/protocol_overview.md
diff --git a/...ent-docs/current/socket/socket-otp-api.md → ...nt/api-reference/socket/socket-otp-api.md b/...ent-docs/current/socket/socket-otp-api.md → ...nt/api-reference/socket/socket-otp-api.md
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/getting-developed/_category_.json b/i18n/en/docusaurus-plugin-content-docs/current/getting-developed/_category_.json
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/getting-started.md b/i18n/en/docusaurus-plugin-content-docs/current/getting-started.md
@@ -1045,5 +1045,7 @@ For detailed SDK API document, please visit:
 
 ## Contact & Feedback
 
-- GitHub Issues: <https://github.com/longportapp/openapi-sdk>
-- Join **Discord** LongPort OpenAPI Server: <https://discord.gg/2gUTSCS6>
+| Contact | Description                                         |
+| ------- | --------------------------------------------------- |
+| GitHub  | <https://github.com/longportapp/openapi-sdk/issues> |
+| Discord | <https://discord.gg/2gUTSCS6>                       |
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/socket/overview.md b/i18n/en/docusaurus-plugin-content-docs/current/socket/overview.md
diff --git a/i18n/zh-HK/docusaurus-plugin-content-docs/current/api-reference/_category_.json b/i18n/zh-HK/docusaurus-plugin-content-docs/current/api-reference/_category_.json
@@ -0,0 +1,7 @@
+{
+  "position": 4.5,
+  "label": "API 附錄",
+  "collapsible": true,
+  "collapsed": true,
+  "link": null
+}
diff --git a/.../current/getting-developed/error-codes.md → ...docs/current/api-reference/error-codes.md b/.../current/getting-developed/error-codes.md → ...docs/current/api-reference/error-codes.md
diff --git a/...nt/getting-developed/how-to-access-api.md → ...urrent/api-reference/how-to-access-api.md b/...nt/getting-developed/how-to-access-api.md → ...urrent/api-reference/how-to-access-api.md
@@ -1,11 +1,19 @@
 ---
-title: 如何調用 API
+title: Overview
 id: how-to-access-api
 slug: /how-to-access-api
 sidebar_position: 1
 ---
 
-## 開發前須知
+本部分內容主要介紹 LongPort OpenAPI 的基礎訊息，包括如何存取 API、如何使用 API、如何取得 API 介面文件等，內容較為原始。
+
+:::success 提示
+建議可以直接採用 SDK 的方式存取 API，SDK 已經封裝了 API 的呼叫方式，使用起來更方便。
+
+https://open.longportapp.com/sdk
+:::
+
+## API 須知
 
 | 注意事項                                     | 參考文檔                                          |
 | -------------------------------------------- | ------------------------------------------------- |

diff --git a/...nt/getting-developed/refresh-token-api.md → ...urrent/api-reference/refresh-token-api.md b/...nt/getting-developed/refresh-token-api.md → ...urrent/api-reference/refresh-token-api.md
diff --git a/...ntent-docs/current/socket/_category_.json → ...rent/api-reference/socket/_category_.json b/...ntent-docs/current/socket/_category_.json → ...rent/api-reference/socket/_category_.json
diff --git a/...ontent-docs/current/socket/biz-command.md → ...rrent/api-reference/socket/biz-command.md b/...ontent-docs/current/socket/biz-command.md → ...rrent/api-reference/socket/biz-command.md
diff --git a/...nt-docs/current/socket/control-command.md → ...t/api-reference/socket/control-command.md b/...nt-docs/current/socket/control-command.md → ...t/api-reference/socket/control-command.md
diff --git a/...ontent-docs/current/socket/diff-ws-tcp.md → ...rrent/api-reference/socket/diff-ws-tcp.md b/...ontent-docs/current/socket/diff-ws-tcp.md → ...rrent/api-reference/socket/diff-ws-tcp.md
diff --git a/...ugin-content-docs/current/socket/hosts.md → ...ocs/current/api-reference/socket/hosts.md b/...ugin-content-docs/current/socket/hosts.md → ...ocs/current/api-reference/socket/hosts.md
diff --git a/.../current/socket/how_to_subscribe_quote.md → ...eference/socket/how_to_subscribe_quote.md b/.../current/socket/how_to_subscribe_quote.md → ...eference/socket/how_to_subscribe_quote.md
diff --git a/.../current/socket/how_to_subscribe_trade.md → ...eference/socket/how_to_subscribe_trade.md b/.../current/socket/how_to_subscribe_trade.md → ...eference/socket/how_to_subscribe_trade.md
diff --git a/...s/current/socket/protocol/_category_.json → ...reference/socket/protocol/_category_.json b/...s/current/socket/protocol/_category_.json → ...reference/socket/protocol/_category_.json
diff --git a/...t-docs/current/socket/protocol/connect.md → .../api-reference/socket/protocol/connect.md b/...t-docs/current/socket/protocol/connect.md → .../api-reference/socket/protocol/connect.md
diff --git a/...nt/socket/protocol/how-to-parse-header.md → ...ce/socket/protocol/how-to-parse-header.md b/...nt/socket/protocol/how-to-parse-header.md → ...ce/socket/protocol/how-to-parse-header.md
diff --git a/...rent/socket/protocol/how-to-parse-push.md → ...ence/socket/protocol/how-to-parse-push.md b/...rent/socket/protocol/how-to-parse-push.md → ...ence/socket/protocol/how-to-parse-push.md
diff --git a/...t/socket/protocol/how-to-parse-request.md → ...e/socket/protocol/how-to-parse-request.md b/...t/socket/protocol/how-to-parse-request.md → ...e/socket/protocol/how-to-parse-request.md
diff --git a/.../socket/protocol/how-to-parse-response.md → .../socket/protocol/how-to-parse-response.md b/.../socket/protocol/how-to-parse-response.md → .../socket/protocol/how-to-parse-response.md
diff --git a/...rrent/socket/protocol/how_to_handshake.md → ...rence/socket/protocol/how_to_handshake.md b/...rrent/socket/protocol/how_to_handshake.md → ...rence/socket/protocol/how_to_handshake.md
diff --git a/...rent/socket/protocol/protocol_overview.md → ...ence/socket/protocol/protocol_overview.md b/...rent/socket/protocol/protocol_overview.md → ...ence/socket/protocol/protocol_overview.md
diff --git a/...ent-docs/current/socket/socket-otp-api.md → ...nt/api-reference/socket/socket-otp-api.md b/...ent-docs/current/socket/socket-otp-api.md → ...nt/api-reference/socket/socket-otp-api.md
diff --git a/i18n/zh-HK/docusaurus-plugin-content-docs/current/getting-developed/_category_.json b/i18n/zh-HK/docusaurus-plugin-content-docs/current/getting-developed/_category_.json
diff --git a/i18n/zh-HK/docusaurus-plugin-content-docs/current/getting-started.md b/i18n/zh-HK/docusaurus-plugin-content-docs/current/getting-started.md
@@ -963,12 +963,10 @@ SDK 的詳細 API 文檔請訪問：
 
 <https://longportapp.github.io/openapi-sdk/>
 
-- GitHub Issues: <https://github.com/longportapp/openapi-sdk/>
+## 回饋及溝通
 
-- 微信溝通羣（已滿）：
-
-<img src="https://pub.lbkrs.com/files/202205/akTNrRTBrT5aMX4f/qrcode.jpg" className="max-w-2xl" />
-
-- 飛書溝通羣：
-
-<img src="https://assets.lbkrs.com/uploads/2acb32b6-0718-4304-8d73-432a2d53aa97/feishu.png" className="max-w-2xl" />
+| 頻道                 | 二維碼 / 連結                                                                                  |
+| -------------------- | ---------------------------------------------------------------------------------------------- |
+| GitHub Issues        | <https://github.com/longportapp/openapi-sdk/issues>                                            |
+| 微信溝通群（已完成） | <img src="https://pub.lbkrs.com/files/202205/akTNrRTBrT5aMX4f/qrcode.jpg" />                   |
+| 飛書溝通群           | <img src="https://assets.lbkrs.com/uploads/2acb32b6-0718-4304-8d73-432a2d53aa97/feishu.png" /> |
diff --git a/i18n/zh-HK/docusaurus-plugin-content-docs/current/quote/_category_.json b/i18n/zh-HK/docusaurus-plugin-content-docs/current/quote/_category_.json
@@ -1,7 +1,7 @@
 {
   "label": "行情",
   "collapsible": true,
-  "collapsed": true,
+  "collapsed": false,
   "link": null,
   "position": 3
 }
diff --git a/i18n/zh-HK/docusaurus-plugin-content-docs/current/socket/overview.md b/i18n/zh-HK/docusaurus-plugin-content-docs/current/socket/overview.md
diff --git a/i18n/zh-HK/docusaurus-plugin-content-docs/current/trade/_category_.json b/i18n/zh-HK/docusaurus-plugin-content-docs/current/trade/_category_.json
@@ -1,7 +1,7 @@
 {
   "label": "交易",
   "collapsible": true,
-  "collapsed": true,
+  "collapsed": false,
   "position": 4,
   "link": null
 }