ProjectHentai/nonebot2
6
0
Fork 0
mirror of https://github.com/nonebot/nonebot2.git synced 2024-11-24 09:05:04 +08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Fix docs

Browse Source
This commit is contained in:
Richard Chien 2018-12-19 20:44:03 +08:00
parent 92bd3105cb
commit 034f121cc0
1 changed files with 9 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/guide/calling-cqhttp-api.md
View File

@ -7,7 +7,7 @@
[python-aiocqhttp]: https://github.com/richardchien/python-aiocqhttp
```python
bot.send_private_msg(user_id=12345678, message='你好～')
await bot.send_private_msg(user_id=12345678, message='你好～')
```
这里，`send_private_msg` 实际上对应 CQHTTP 的 [`/send_private_msg` 接口](https://cqhttp.cc/docs/#/API?id=send_private_msg-%E5%8F%91%E9%80%81%E7%A7%81%E8%81%8A%E6%B6%88%E6%81%AF)，其它接口同理。
@ -15,6 +15,7 @@ bot.send_private_msg(user_id=12345678, message='你好～')
通过这种方式调用 API 时，需要注意两点：
1. **所有参数必须为命名参数（keyword argument）**，否则无法正确调用
2. 这种调用全都是异步调用，因此需要适当 `await`
2. **调用失败时（没有权限、对方不是好友、无 API 连接等）可能抛出 `none.CQHttpError` 异常**，注意捕获
另外，在需要动态性的场合，除了使用 `getattr()` 方法外，还可以直接调用 `bot.call_action()` 方法，传入 `action` 和 `params` 即可，例如上例中，`action` 为 `'send_private_msg'`，`params` 为 `{'user_id': 12345678, 'message': '你好～'}`。
@ -22,17 +23,17 @@ bot.send_private_msg(user_id=12345678, message='你好～')
下面举出一些主动发送消息和调用 API 的例子：
```python
bot.send_private_msg(user_id=12345678, message='你好～')
bot.send_group_msg(group_id=123456, message='大家好～')
await bot.send_private_msg(user_id=12345678, message='你好～')
await bot.send_group_msg(group_id=123456, message='大家好～')
ctx = session.ctx.copy()
del ctx['message']
bot.send_msg(**ctx, message='喵～')
await bot.send_msg(**ctx, message='喵～')
bot.delete_msg(**session.ctx)
bot.set_group_card(**session.ctx, card='新人请改群名片')
self_info = bot.get_login_info()
group_member_info = bot.get_group_member_info(group_id=123456, user_id=12345678, no_cache=True)
await bot.delete_msg(**session.ctx)
await bot.set_group_card(**session.ctx, card='新人请改群名片')
self_info = await bot.get_login_info()
group_member_info = await bot.get_group_member_info(group_id=123456, user_id=12345678, no_cache=True)
```
其它更多接口请自行参考 CQHTTP 的 [API 列表](https://cqhttp.cc/docs/#/API?id=api-列表)。