Slack

简介

Slack API 支撑整个 Slack 工作区的机器人和集成：发送消息、读取频道、管理用户、斜杠命令和交互式工作流。认证是 OAuth（bot token / user token），需在 api.slack.com 注册应用——没有匿名访问。

快速开始

Web API 需要 bot token（在 api.slack.com/apps 创建应用 → 安装到工作区）：

# 发送消息：
curl -X POST "https://slack.com/api/chat.postMessage" \
  -H "Authorization: Bearer xoxb-YOUR_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channel": "general", "text": "Hello from an API!"}'

频道列表：

curl "https://slack.com/api/conversations.list?limit=10" \
  -H "Authorization: Bearer xoxb-YOUR_BOT_TOKEN"

认证方式

• 仅 OAuth：注册应用、安装到工作区、使用颁发的 bot token（xoxb-...）。
• 令牌带细粒度 scope（channels:read、chat:write……）——请求最小权限。
• 用户令牌（xoxp-...）代表用户操作；列表的 OAuth 标记即指所有这些。
• 切勿在客户端代码暴露令牌。

速率限制与注意事项

• 按方法限流（分档；大约每秒 1-50 次，视方法而定）。
• chat.postMessage 接受类 Markdown 文本；blocks/attachments 支持富布局。
• Events API + Socket Mode 可实现实时机器人而无需暴露公网端点。
• Webhook “Incoming Webhooks” 是用一个 URL 往单个频道发消息的最简方式。

常见问题

Slack API 免费吗？ 是的——API 本身免费；限额取决于工作区套餐。

需要令牌吗？ 是的——OAuth bot/user token；没有匿名访问。

如何创建机器人？ api.slack.com/apps → Create New App → 添加 scope → Install to Workspace。