nonebot-adapter-afdian

基于 NoneBot2 的爱发电适配器

使用

1. 安装

   pip install nonebot-adapter-afdian
   

2. 启用

   adapters = [
       { name = "Afdian", module_name = "nonebot.adapter.afdian" }
   ]
   

3. 配置

   • NoneBot2

     DRIVER=~fastapi+~httpx
     HOST=0.0.0.0
     AFDIAN_HOOK_SECRET='<Your Secret>'
     AFDIAN_BOTS='[
         {
             "user_id": "<Your User Id>",
             "token": "<Your Token>"
         }
     ]'
     # 可选：Webhook 签名验证公钥（PEM），留空使用内置平台公钥
     AFDIAN_WEBHOOK_PUBLIC_KEY=''
     

   • 爱发电开发者控制台

     http://<IP>:<PORT>/afdian/webhooks/<user_id>
     

     or

     https://<IP>:<PORT>/afdian/<Your Secret>/webhooks/<user_id>
     

Webhook 签名验证

2025-07-01 起爱发电 Webhook 推送携带 sign 签名字段，适配器会使用内置平台公钥自动进行本地验签（RSA-SHA256），无需额外配置。

如平台更换公钥，可通过 AFDIAN_WEBHOOK_PUBLIC_KEY 配置自定义 PEM 公钥覆盖。未携带签名的旧版推送仍走订单回查验证。

API

from nonebot import on_notice
from nonebot.adapters.afdian import OrderNotifyEvent, Bot

test_afd = on_notice()


@test_afd.handle()
async def handle_afd(bot: Bot, event: OrderNotifyEvent):
    print("订单：" + event.data.order)

    result1 = await bot.query_order_by_page(page=1)
    print(result1)

    result2 = await bot.query_order_by_out_trade_no(
        out_trade_no="202308200000000000000000001"
        )
    print(result2)

    result3 = await bot.query_order_by_order_list(
        order_list=["202308200000000000000000000", "202308200000000000000000001"]
        )
    print(result3)

    result4 = await bot.query_sponsor(page=1)
    print(result4)

    result5 = await bot.query_sponsor(page=1, per_page=20) # 查询第一页，每页20个
    print(result5)

    # 根据订单号查询随机自动回复
    result6 = await bot.query_random_reply(
        out_trade_no="202308200000000000000000001"
        )
    print(result6)

    # 通过 API 填入自动回复（可用于补货、发码等场景）
    result7 = await bot.update_plan_reply(
        plan_id="<Your Plan Id>",  # 与 sku_id 二选一
        auto_random_reply="<New Code>",
        update_random_reply_type="overwrite",  # append 追加 / overwrite 覆盖
        )
    print(result7)

    # 发送私信（平台限频 10 次/秒 和 1000 次/小时）
    result8 = await bot.send_msg(recipient="<User Id>", content="<Content>")
    print(result8)

    # 查看方案详情
    result9 = await bot.query_plan(plan_id="<Your Plan Id>")
    print(result9)

    # 查询创作者的所有方案（非官方 Web API，无需签名，仅含已上架的公开方案）
    result10 = await bot.query_creator_plans()  # 默认查询当前 Bot 的 user_id
    result11 = await bot.query_creator_plans(user_id="<User Id>")  # 也可以查别人
    print(result10, result11)

特别感谢

• NoneBot2：开发框架。

贡献与支持

觉得好用可以给这个项目点个 Star 或者去 爱发电 投喂我。

有意见或者建议也欢迎提交 Issues 和 Pull requests 。

开源许可

本项目使用 MIT 作为开源许可证。