认证概览

滴答清单API提供两种认证方式，您可以根据使用场景选择合适的登录方法。

认证方式对比

特性	密码登录	微信登录
便利性	需要输入用户名密码	扫码即可
安全性	依赖密码强度	依赖微信安全体系
适用场景	自动化脚本、批量操作	交互式使用
实现复杂度	简单直接	复杂（需要轮询）
网络要求	一次HTTP请求	多次请求和轮询
用户体验	传统表单登录	现代扫码体验

认证流程

密码登录流程

sequenceDiagram
    participant User as 用户
    participant Client as 客户端
    participant API as API服务器
    participant Dida as 滴答清单服务器

    User->>Client: 1. 输入用户名密码
    Client->>API: 2. POST https://api.dida365.com/api/v2/user/signon
    API->>Dida: 3. 验证登录凭据
    Dida-->>API: 4. 返回认证令牌
    API->>API: 5. 保存会话信息
    API-->>Client: 6. 返回登录结果
    Client->>User: 7. 显示登录状态

微信登录流程

sequenceDiagram
    participant User as 用户
    participant Client as 客户端
    participant API as API服务器
    participant WeChat as 微信服务器
    participant Dida as 滴答清单服务器

    User->>Client: 1. 请求微信登录
    Client->>API: 2. GET https://open.weixin.qq.com/connect/qrconnect
    API->>WeChat: 3. 获取二维码
    WeChat-->>API: 4. 返回二维码
    API-->>Client: 5. 返回二维码URL
    Client->>User: 6. 显示二维码

    User->>WeChat: 7. 微信扫码确认
    Client->>API: 8. GET https://lp.open.weixin.qq.com/connect/l/qrconnect
    API->>WeChat: 9. 轮询登录状态
    WeChat-->>API: 10. 返回授权码
    API->>Dida: 11. 验证授权码
    Dida-->>API: 12. 返回认证令牌
    API->>API: 13. 保存会话信息
    API-->>Client: 14. 返回登录结果

详细文档

密码登录相关

• 密码登录 - 详细的密码登录接口文档

微信登录相关

• 微信登录流程 - 完整的微信扫码登录流程
• 获取微信二维码 - 获取微信登录二维码
• 轮询登录状态 - 检查二维码扫码状态
• 验证微信登录 - 验证微信登录并获取令牌