【对外接口文档】聊天接口API

输入“/”快速插入内容

【对外接口文档】聊天接口API

用户9198

用户9639

用户5704

3月16日修改

1.
简介​

ZelinAI应用聊天请求接口，用于应用聊天交互。

2.
更新历史​

V1.2.1 版本

发布时间

该版本发布于 2023 年 5 月 15 日。

发布内容

类型

说明

新增

ZelinAI接口文档

3.
调用方法​

3.1 前提条件

暂无

3.2 请求结构

服务地址：https://zelinai.com/

通信协议：HTTPS

3.3 公共参数

公共请求参数

暂无

公共返回参数

名称

类型

说明

status

int

200-正常；非200-异常

message

string

status状态说明

data

object

返回的内容

3.4 鉴权机制

•
为了确保接口调用的安全，每个接口在请求的时候，都要附带签名signature字段；鉴权逻辑：​
◦
signature签名一致；​
◦
timestamp相差在30s以内（正负30s）；​

•
在请求的Header中添加如下参数​

名称

类型

是否必填

说明

appkey

string(32)

是

业务方appkey

nonce

string(16)

是

长度为16的随机字符串

timestamp

long

是

当前时间戳，单位秒

signature

string

是

签名字符串，加签方法见下文

•
注：在构造签名的字符串中，除了上述appkey、nonce、timestamp之外，可能还包括其他参数，具体看各个接口请求参数的“签名参数”列，值为“是”的都需要纳入进来一起加签；​

•
计算签名的方法如下：​
◦
签名字段包含appkey、nonce和timestamp，还有接口包含的其他业务参数；​
◦
所有待签名参数按照字段名的ASCII 码从小到大排序（字典序），然后使用 URL 键值对的格式（即key1=value1&key2=value2…）拼接成字符串s1。（注：值为空的不计入签名；）​
◦
在 s1 字符串后面直接拼接 appsecret 作为签名字符串，即s1{appsecret}；​
◦
对签名字符串调用MD5签名，生成signature字符串，MD5(s1{appsecret})​
▪
注意：md5结果值需要转换成小写​

•
注：appkey、appsecret是业务方唯一标示，由平台生成，请在控制台后台-系统设置里面获取；​

【对外接口文档】聊天接口API​

【对外接口文档】聊天接口API