From 3ed6fdc19237c1953b65fc616cf32e52e8b0cc61 Mon Sep 17 00:00:00 2001
From: haoxiuwen <amy.hao@easemob.com>
Date: Fri, 8 Dec 2023 16:12:14 +0800
Subject: [PATCH 1/2] Add API Call Limitation for Instant Push

---
 docs/.vuepress/sidebar/push.ts        |  1 +
 docs/push/push_api_call_limitation.md | 28 +++++++++++++++++++++++++++
 2 files changed, 29 insertions(+)
 create mode 100644 docs/push/push_api_call_limitation.md

diff --git a/docs/.vuepress/sidebar/push.ts b/docs/.vuepress/sidebar/push.ts
index 0c0d424d3..ee54ed929 100644
--- a/docs/.vuepress/sidebar/push.ts
+++ b/docs/.vuepress/sidebar/push.ts
@@ -9,6 +9,7 @@ export const PUSH_SIDEBAR = [
           { text: 'iOS SDK 发布动态', link: 'push_dynamics_ios.html' },
         ]},
         { text: '全球化部署', link: 'push_global_deployment.html' },
+        { text: '接口频率限制', link: 'push_api_call_limitation.html' },
       ]
     },
     {
diff --git a/docs/push/push_api_call_limitation.md b/docs/push/push_api_call_limitation.md
new file mode 100644
index 000000000..ac22c7930
--- /dev/null
+++ b/docs/push/push_api_call_limitation.md
@@ -0,0 +1,28 @@
+# 即时推送 Restful API 调用频率限制
+
+<Toc />
+
+## 推送标签管理
+
+| RESTful API 接口 |方法  | 接口 URL| 接口最高调用频率（默认值） |
+| :----------- | :----- | :------------------- | :------------- |
+| 创建推送标签  | POST   | /{org_name}/{app_name}/push/label   | 100 次/秒/App Key   |
+| 查询指定的推送标签  | GET | /{org_name}/{app_name}/push/label/{labelname}   | 100 次/秒/App Key         |
+| 分页查询推送标签   | GET   | /{org_name}/{app_name}/push/label  | 100 次/秒/App Key   |
+| 删除指定的推送标签   | DELETE   | /{org_name}/{app_name}/push/label/{labelname}    | 100 次/秒/App Key    |
+| 在推送标签下添加用户   | POST   | /{org_name}/{app_name}/push/label/{labelname}/user    | 300 次/秒/App Key    |
+| 查询指定标签下的指定用户   | GET   | /{org_name}/{app_name}/push/label/{labelname}/user/{username}    | 300 次/秒/App Key    |
+| 分页查询指定标签下的用户  | GET   | /{org_name}/{app_name}/push/label/{labelname}/user    | 300 次/秒/App Key    |
+| 批量移出指定推送标签下的用户   | DELETE   | /{org_name}/{app_name}/push/label/{labelname}/user    | 300 次/秒/App Key    |
+
+## 发送推送通知
+
+| RESTful API 接口 |方法  | 接口 URL| 接口最高调用频率（默认值） |
+| :----------- | :----- | :------------------- | :------------- |
+| 以同步方式发送推送通知 | POST  | /{org_name}/{app_name}/push/sync/{target} | 10 次/秒/App Key  |
+| 以异步方式批量发送推送通知 | POST | /{org_name}/{app_name}/push/single | 100 次/秒/App Key |
+| 使用标签推送接口发送推送通知 | POST | /{org_name}/{app_name}/push/list/label | 100 次/秒/App Key |
+| 创建全量推送任务 | POST | /{org_name}/{app_name}/push/task | 10 次/秒/App Key |
+| 创建推送通知 | POST | /{org_name}/{app_name}/push/message  | 10 次/秒/App Key |
+| 查询推送通知 | POST| /{org_name}/{app_name}/push/message/{messageId} | 10 次/秒/App Key|
+| 创建全量推送任务| POST | /{org_name}/{app_name}/push/task/broadcast |10 次/秒/App Key |
\ No newline at end of file

From 6bbba3769ac49c8627a720f1ca12de5023cd9331 Mon Sep 17 00:00:00 2001
From: haoxiuwen <amy.hao@easemob.com>
Date: Fri, 8 Dec 2023 16:15:40 +0800
Subject: [PATCH 2/2] modify

---
 docs/push/push_api_call_limitation.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/push/push_api_call_limitation.md b/docs/push/push_api_call_limitation.md
index ac22c7930..df3351217 100644
--- a/docs/push/push_api_call_limitation.md
+++ b/docs/push/push_api_call_limitation.md
@@ -1,4 +1,6 @@
-# 即时推送 Restful API 调用频率限制
+# 即时推送 RESTful API 调用频率限制
+
+本文介绍即时推送 RESTful API 的调用频率限制，包括推送标签管理和发送推送通知相关的 API 的调用频率限制。
 
 <Toc />