padlocal-client-ts

NPM Version TypeScript Stage

本项目是 PadLocal 的 TypeScript 客户端,JavaScript 项目也可以。同时作为核心组件,为 wechaty-puppet-padlocal 提供了聊天机器人相关功能的技术支持。

如何使用

和 Wechaty 一起使用

如果你是聊天机器人的初学者,建议先尝试 Wechaty 。Wechaty 是一个非常易用的聊天机器人框架,有丰富的技术文档和优秀的社区,被广大开发者喜爱。

如果你熟悉甚至已经在使用 Wechaty,那么你可以将 wechaty-puppet-padlocal 作为 Wechaty 的 puppet 来使用,支持和其他 puppet 无缝切换。因为 wechaty-puppet-padlocal 是一个完整的 Wechaty puppet 实现,且由 padlocal-client-ts 提供技术支持。

系统架构

直接使用

当然 padlocal-client-ts 也支持直接单独使用。我们为你提供了一个可以快速开始的 demo 项目

  1. 安装 node https://nodejs.org/en/
  2. 下载 demo 项目并安装依赖
$ git clone git@github.com:padlocal/padlocal-client-ts-demo.git

$ cd padlocal-client-ts-demo
$ npm install

将你的 PadLocal token 配置在代码 main.ts

  ////////////////// 在这里填入你的 PadLocal Token //////////////////
  const token: string = "puppet_padlocal_xxx";
  ////////////////////////////////////////////////////////////////
  1. 运行 demo
$ npm run demo

命令行中则会出现二维码,然后扫码登录即可。

00:00:00 INFO
      ============================================================
                    Welcome to padlocal-client-ts !
                           version: 0.2.32
      ============================================================

start login
start login with type:  0

▼▼▼ Please scan following qr code to login ▼▼▼

▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█ ▄▄▄▄▄ █▄▄████ █▄▄ ▄▀█ ▄▄▄▄▄ █
█ █   █ █ ▀█ ▄ ▀  █▄ ▀█ █   █ █
█ █▄▄▄█ █▄ ▄▄▀ ██ ██ ▀█ █▄▄▄█ █
█▄▄▄▄▄▄▄█▄▀▄▀▄█▄▀▄▀ ▀▄█▄▄▄▄▄▄▄█
█▄▄ ▄██▄█ ▀████▀█▀▄ ▀█ ▀▀ ▄▄█ █
█▄▄ █▀ ▄▀ ██▀▀  █▀▄▀▀▀▄▄█▀▀▄▄▀█
█ █ ▀█▀▄ ▀ ▀ █▄█▄  ▀ █▄▀██▄▄▀▀█
█▄ ▄▀█▀▄█▄ ██ ▄█▀▀██   ▀██▄▄ ▄█
█▄ █▀  ▄▀▄  ▄▀ █ ██▀▄  █▀▄█▀ ██
█ ▄▄▄▄▄ ██▄ ▄▄▀▄████▄ █▄█ ▄█ ██
█ █   █ █▀▀ ▀ ▀▄█▀▀▀█▄ ▄    ▄ █
█ █▄▄▄█ █  ▄ ██ ▀▄▄▀█  █ ▀▀▄▀▄█
█▄▄▄▄▄▄▄█▄█▄███▄▄█▄▄█▄▄█████▄██

你也可以查阅本项目的测试用例,里面有大量的详细使用示例:https://github.com/padlocal/padlocal-client-ts/tree/master/tests 。 可以特别关注如下文件:

  • Common.ts
  • PadLocalClient-login.test.ts
  • PadLocalClient-push.test.ts
  • PadLocalClient-api.test.ts

API

所有支持的 API 请参见:

  • PadLocalClientApi.ts

How to apply token

TOKEN 申请方法