Merge pull request #286 from whtsky/doc

docs(handler): add doc for card handler

Author: whtsky

docs/handlers.rst

@@ -53,33 +53,46 @@ WeRoBot会将合法的请求发送给 handlers 依次执行。
 
 在 WeRobot 中我们把请求分成了 Message 和 Event 两种类型,针对两种类型的请求分别有不同的 Handler。
 
-======================================  =================
-修饰符                                   类型
-======================================  =================
-robot.text                              文本 (Message)
-robot.image                             图像 (Message)
-robot.location                          位置 (Message)
-robot.link                              链接 (Message)
-robot.voice                             语音 (Message)
-robot.unknown                           未知类型 (Message)
-robot.subscribe                         被关注 (Event)
-robot.unsubscribe                       被取消关注 (Event)
-robot.click                             自定义菜单事件 (Event)
-robot.view                              链接 (Event)
-robot.scancode_push                     扫描推送 (Event)
-robot.scancode_waitmsg                  扫描弹消息 (Event)
-robot.pic_sysphoto                      弹出系统拍照发图（Event）
-robot.pic_photo_or_album                弹出拍照或者相册发图（Event）
-robot.pic_weixin                        弹出微信相册发图器（Event）
-robot.location_select                   弹出地理位置选择器（Event）
-robot.scan                              已关注扫描二维码（Event）
-robot.user_scan_product                 打开商品主页事件推送（Event）
-robot.user_scan_product_enter_session   进入公众号事件推送（Event）
-robot.user_scan_product_async           地理位置信息异步推送（Event)
-robot.user_scan_product_verify_action   商品审核结果推送（Event）
-robot.location_event                    上报位置 (Event)
-robot.unknown_event                     未知类型 (Event)
-======================================  =================
+========================================================================================================  =========================================
+修饰符                                                                                                       类型
+========================================================================================================  =========================================
+:func:`robot.text <werobot.robot.BaseRoBot.text>`                                                           文本 (Message)
+:func:`robot.image <werobot.robot.BaseRoBot.image>`                                                         图像 (Message)
+:func:`robot.location <werobot.robot.BaseRoBot.location>`                                                   位置 (Message)
+:func:`robot.link <werobot.robot.BaseRoBot.link>`                                                           链接 (Message)
+:func:`robot.voice <werobot.robot.BaseRoBot.voice>`                                                         语音 (Message)
+:func:`robot.unknown <werobot.robot.BaseRoBot.unknown>`                                                     未知类型 (Message)
+:func:`robot.subscribe <werobot.robot.BaseRoBot.subscribe>`                                                 被关注 (Event)
+:func:`robot.unsubscribe <werobot.robot.BaseRoBot.unsubscribe>`                                             被取消关注 (Event)
+:func:`robot.click <werobot.robot.BaseRoBot.click>`                                                         自定义菜单事件 (Event)
+:func:`robot.view <werobot.robot.BaseRoBot.view>`                                                           链接 (Event)
+:func:`robot.scancode_push <werobot.robot.BaseRoBot.scancode_push>`                                         扫描推送 (Event)
+:func:`robot.scancode_waitmsg <werobot.robot.BaseRoBot.scancode_waitmsg>`                                   扫描弹消息 (Event)
+:func:`robot.pic_sysphoto <werobot.robot.BaseRoBot.pic_sysphoto>`                                           弹出系统拍照发图（Event）
+:func:`robot.pic_photo_or_album <werobot.robot.BaseRoBot.pic_photo_or_album>`                               弹出拍照或者相册发图（Event）
+:func:`robot.pic_weixin <werobot.robot.BaseRoBot.pic_weixin>`                                               弹出微信相册发图器（Event）
+:func:`robot.location_select <werobot.robot.BaseRoBot.location_select>`                                     弹出地理位置选择器（Event）
+:func:`robot.scan <werobot.robot.BaseRoBot.scan>`                                                           已关注扫描二维码（Event）
+:func:`robot.user_scan_product <werobot.robot.BaseRoBot.user_scan_product>`                                 打开商品主页事件推送（Event）
+:func:`robot.user_scan_product_enter_session <werobot.robot.BaseRoBot.user_scan_product_enter_session>`     进入公众号事件推送（Event）
+:func:`robot.user_scan_product_async <werobot.robot.BaseRoBot.user_scan_product_async>`                     地理位置信息异步推送（Event)
+:func:`robot.user_scan_product_verify_action <werobot.robot.BaseRoBot.user_scan_product_verify_action>`     商品审核结果推送（Event）
+:func:`robot.card_pass_check <werobot.robot.BaseRoBot.card_pass_check>`                                     卡券通过审核 (Event)
+:func:`robot.card_not_pass_check <werobot.robot.BaseRoBot.card_not_pass_check>`                             卡券未通过审核 (Event)
+:func:`robot.user_get_card <werobot.robot.BaseRoBot.user_get_card>`                                         用户领取卡券 (Event)
+:func:`robot.user_gifting_card <werobot.robot.BaseRoBot.user_gifting_card>`                                 用户转赠卡券 (Event)
+:func:`robot.user_del_card <werobot.robot.BaseRoBot.user_del_card>`                                         用户删除卡券 (Event)
+:func:`robot.user_consume_card <werobot.robot.BaseRoBot.user_consume_card>`                                 卡券被核销 (Event)
+:func:`robot.user_pay_from_pay_cell <werobot.robot.BaseRoBot.user_pay_from_pay_cell>`                       微信买单完成 (Event)
+:func:`robot.user_view_card <werobot.robot.BaseRoBot.user_view_card>`                                       用户进入会员卡 (Event)
+:func:`robot.user_enter_session_from_card <werobot.robot.BaseRoBot.user_enter_session_from_card>`           用户卡券里点击查看公众号进入会话 (Event)
+:func:`robot.update_member_card <werobot.robot.BaseRoBot.update_member_card>`                               会员卡积分余额发生变动 (Event)
+:func:`robot.card_sku_remind <werobot.robot.BaseRoBot.card_sku_remind>`                                     库存警告 (Event)
+:func:`robot.card_pay_order <werobot.robot.BaseRoBot.card_pay_order>`                                       券点发生变动 (Event)
+:func:`robot.submit_membercard_user_info <werobot.robot.BaseRoBot.submit_membercard_user_info>`             激活卡券 (Event)
+:func:`robot.location_event <werobot.robot.BaseRoBot.location_event>`                                       上报位置 (Event)
+:func:`robot.unknown_event <werobot.robot.BaseRoBot.unknown_event>`                                         未知类型 (Event)
+========================================================================================================  =========================================
 
 额，这个 handler 想处理文本信息和地理位置信息？ ::