SDK
Chatopera 机器人平台用户可以在不同的软件系统、程序中接入 Chatopera 机器人。 SDK 是面向不同编程语言和 Chatopera 机器人平台集成的工具库,包括 Node.js、Go、PHP、Python、Java 等。
能力概述
SDK 能力概述:使用 Chatopera
类创建机器人、获得机器人信息;使用 Chatbot
类管理某一机器人的资源; Chatopera
类是系统账户级别,Chatbot
是单个机器人级别。
Chatopera
类使用控制台中【访问设置】的 Personal Access Token
实例化,Chatbot
类使用每个机器人的 clientId
和 secret
初始化。
下载安装
SDK 简化了集成的复杂度,某些语言可以通过包管理工具安装。SDK 下载地址参考列表:
语言 | 下载地址 | 使用指南 |
---|---|---|
Python | chatopera-py-sdk | 示例程序 / 技术支持 |
Java | chatopera-java-sdk | 示例程序 / 技术支持 / JavaDocs |
Go | chatopera-go-sdk | 示例程序 / 技术支持 |
PHP | chatopera-php-sdk | 示例程序 / 技术支持 |
Node.js | chatopera-nodejs-sdk | 示例程序 / 技术支持 |
为了方便开发者调用 SDK,每个 SDK 内均有示例程序或测试程序作为参考。
提示: 以上 SDK 同时支持私有部署的 Chatopera 机器人平台。
在聊天机器人的一级菜单,可以进入集成页面查看。
如不能满足您使用环境或者语言的 SDK,请创建工单进行描述,Chatopera 将尽快满足您的需求。
核心类
在每个语言的 SDK 中,均实现两个类:Chatopera
类和Chatbot
类。
Chatopera
类
Chatopera
类是与 Chatopera 机器人平台集成的一个高级类,因为 Chatopera 云服务为开发者提供聊天机器人服务,Chatopera
类的对象就是 Chatopera 云服务中一个注册账户的代理。
通过左侧导航菜单了解使用详情。
Chatbot
类
Chatbot
类是与 Chatopera 云服务集成的一个核心类,因为 Chatopera 云服务为开发者提供聊天机器人服务,Chatbot
类的对象就是 Chatopera 云服务中一个聊天机器人的代理。
通过左侧导航菜单了解使用详情。
已知问题
在 Windows WSL 内调用 SDK,返回异常 invalid timestamp
错误原因:Windows WSL 的时间同步有 BUG,未能和互联网时间同步。
解决方案:执行手动的时间同步。
假设使用的 WSL 发行版本基于 Ubuntu, 那么可以执行下面的命令解决。
sudo apt-get install ntpdate
sudo ntpdate time.windows.com