发起请求

请求 URL

Bot API 请求 URL 格式：

https://api.example.com/bot{token}/{method}

• {token} — 机器人 Token
• {method} — API 方法名（小写）

例如：

POST https://api.example.com/bot123456:ABC-DEF/sendmessage

HTTP 方法

• 大多数方法支持 GET 和 POST
• 发送媒体文件的方法仅支持 POST（使用 multipart/form-data）

请求格式

JSON

curl -X POST "https://api.example.com/bot{token}/sendmessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": 123456789,
    "text": "Hello"
  }'

multipart/form-data

用于发送文件：

curl -X POST "https://api.example.com/bot{token}/sendphoto" \
  -F "chat_id=123456789" \
  -F "photo=@/path/to/photo.jpg" \
  -F "caption=My photo"

响应格式

所有响应均为 JSON 格式。

成功响应

{
  "ok": true,
  "result": { }
}

result 字段包含请求结果，类型根据方法不同而不同。

错误响应

{
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: chat not found",
  "trace_id": "abc123"
}

文件上传

通过 file_id

如果文件已经上传过，可以使用 file_id 直接引用：

{
  "chat_id": 123456789,
  "photo": "AgACAgIAAxkBAAI..."
}

通过 multipart/form-data

直接上传文件：

curl -X POST "https://api.example.com/bot{token}/senddocument" \
  -F "chat_id=123456789" \
  -F "document=@/path/to/file.pdf"

文件大小限制

类型	最大大小
照片	10 MB
文档	100 MB
媒体组	最多 10 个文件

常见错误码

错误码	说明
400	请求参数错误
401	Token 无效或已过期
403	Bot 无权执行此操作
404	方法不存在
429	请求过于频繁（限流）
500	服务器内部错误