← 所有 API
Slack Web API logo

Slack Web API

Slack Web API

正常免费collaborationSlack

Slack Web API 让应用读写消息、操作频道、上传文件，是构建 Slack bot 与集成的核心。

访问站点 ↗健康巡检 9 小时前
适合什么时候用

OAuth scope 颗粒度细致

先注意什么

速率限制按 method 分级，热点 method 较严

第一步先查

到 api.slack.com 创建一个 Slack App，配置所需 OAuth scopes，安装到某个 workspace 取得 Bot User OAuth Token。所有 API 请求用 Authorization: Bearer <token>。开发交互式应用推荐用官方 Bolt SDK。

认证
oauth
CORS
不支持
HTTPS
是
注册
需要
延迟
454 ms
协议
REST
计费
freemium

可用率 · 30 天窗口

巡检: 1可用率: 100%平均延迟: 454ms
01

关于这个 API

Slack Web API 是 slack.com 提供的 REST 接口，让外部应用与 Slack workspace 交互：发消息、管频道、上传文件、查询用户。它与另外两套 API（Events API 推送实时事件、Socket Mode 用 WebSocket 给本地开发省去公网回调）配合，构成 Slack 应用开发的完整骨架。

认证基于 OAuth 2.0 + scope 体系——每种操作需要相应的 scope（chat:write、channels:read、files:write 等），管理员安装应用时确认所需权限。Bot Token 与 User Token 区别明确：前者是应用代表自身行动，后者是代表用户行动。

Block Kit 是 Slack 推出的消息排版规范，让按钮、菜单、图片、表单字段在消息中渲染得整齐统一。配合 Modals、Home Tab 等界面构造能力，外部应用可以做出接近原生的交互体验。Free workspace 下部分高级方法（如长期消息历史）受限；速率限制按 method tier 划分，热门方法（如 chat.postMessage）较严，应预先了解。

02

你可以做什么

  • 1发布提醒、监控告警到指定频道
  • 2搭建斜杠命令与交互按钮
  • 3将外部事件同步进 Slack 讨论流
  • 4抓取频道消息做归档或分析
  • 5响应表情反应触发工作流
03

优劣对比

优点

  • OAuth scope 颗粒度细致
  • Block Kit 让消息排版像写组件
  • Events API 推送实时事件，省去轮询
  • 官方 Bolt SDK 极大简化机器人开发

注意事项

  • 速率限制按 method 分级，热点 method 较严
  • 某些方法对 free workspace 有功能限制
  • 一次性大量历史消息抓取需走 Tier 2 速率
04

示例请求

通用模板 — 实际 endpoint 请查阅文档替换 <endpoint>。
curl https://api.slack.com/support/<endpoint> \
  -H "Authorization: Bearer $ACCESS_TOKEN"
05

快速开始

到 api.slack.com 创建一个 Slack App，配置所需 OAuth scopes，安装到某个 workspace 取得 Bot User OAuth Token。所有 API 请求用 Authorization: Bearer <token>。开发交互式应用推荐用官方 Bolt SDK。

06

常见问题

API 是免费的吗？+

API 本身免费；调用配额随 workspace 套餐和 method tier 而变。Free workspace 部分功能（如 90 天前历史消息）受限。

Bot Token 和 User Token 有什么区别？+

Bot Token 让应用以自身身份发消息和操作；User Token 让应用代表某个用户操作（如查个人 DM）。绝大多数场景用 Bot Token 即可。

速率限制怎么算？+

按 method 分 Tier 1-4。Tier 1 最严（约 1 次/分钟），常用的 chat.postMessage 在 Tier 1+ 约 1 次/秒/channel。

为什么我的消息没显示出来？+

通常是 scope 不足、token 未授权目标频道、或消息被 Block Kit 校验拒绝。先在 api.slack.com Tester 单独验证。

07

技术细节

CORS: NoHTTPS: Yes注册: Yes开源: No
认证方式
oauth
计费
freemium
协议
REST
SDK
python, javascript, typescript, java, go, ruby
响应时间
454 ms
上次巡检
2026/5/12 07:38:25
08

接口端点

从 OpenAPI spec 自动解析。显示 12 / 174 个未弃用端点。

POST
/admin.apps.approveadmin.appsadmin
token:header*
GET
/admin.apps.approved.listadmin.apps.approvedadmin
token:query*limit:querycursor:queryteam_id:queryenterprise_id:query
GET
/admin.apps.requests.listadmin.apps.requestsadmin
token:query*limit:querycursor:queryteam_id:query
POST
/admin.apps.restrictadmin.appsadmin
token:header*
GET
/admin.apps.restricted.listadmin.apps.restrictedadmin
token:query*limit:querycursor:queryteam_id:queryenterprise_id:query
POST
/admin.conversations.archiveadmin.conversationsadmin
token:header*
POST
/admin.conversations.convertToPrivateadmin.conversationsadmin
token:header*
POST
/admin.conversations.createadmin.conversationsadmin
token:header*
POST
/admin.conversations.deleteadmin.conversationsadmin
token:header*
POST
/admin.conversations.disconnectSharedadmin.conversationsadmin
token:header*
GET
/admin.conversations.ekm.listOriginalConnectedChannelInfoadmin.conversations.ekmadmin
token:query*channel_ids:queryteam_ids:querylimit:querycursor:query
GET
/admin.conversations.getConversationPrefsadmin.conversationsadmin
token:header*channel_id:query*

另有 162 个端点未显示，详见 OpenAPI spec。

09

标签

messagingchatbotcollaborationslackrest
10

可以替代的选择

不同公司、解决相似问题的备选。按分类、认证、计费档位与标签重合度匹配。

并排对比前 3 个 →
Notion APIby Notion
免费oauth

Notion API 让外部应用读写 page 与 database，构建自动化同步、内部工具与 dashboard 集成。

GitHub v3 REST APIby GitHub
免费oauth

GitHub REST API v3，覆盖仓库、issue、PR、Actions、Packages 等所有 GitHub.com 资源的程序化访问。