# AiRestful

AiRestful是一款基于智能AI的,帮助小白快速生成任意编程语言的API接口调用示例代码的编程工具.它的特点是:简单易用集成支持多主流编程语言覆盖.它是面向学生、编程爱好者、编程小白的实用工具.

AiRestful官网: 点击直达AiRestful官网 (opens new window)

在这里插入图片描述

# 二、如何使用

AiRestful简单易用的,只需要三步即可为您生成您需要的编程语言的代码示例.

# 1、第一步(必须):

根据您的接口文档要求, 完成:

  • 请求方式设置: 默认值是 GET
  • API接口填写
  • 参数传入格式设置: 默认值是 application/json

在这里插入图片描述

# 2、第二步(可选):

根据您的接口文档要求, 完成请求参数header的添加设置: (如果您的接口不需要这些参数就可以不添加) 在这里插入图片描述

# 3、第三步(智能生成):

您完成前面两步的相关参数设置和添加后, 就可以在第三步中,选择您需要生成代码的“编程语言“,完成编程语言选择后,点击“立即生成“按钮等待智能生成结果即可. 在这里插入图片描述

AiRestful不仅仅可以帮您生成您需要的编程语言的代码示例,它还可以给您详细的代码使用解释,帮助您使用和理解.

# 三、如何集成到您的网站(应用)

# 1、开始接入

AiRestful (opens new window)是支持接入到您的网站或者应用的,您只需要在您的应用中提供一个“入口“,带上您的api参数跳转至AiRestful即可, 您需要配置的跳转url格式参数如下:

let aiRestfulUrl = `https://luckycola.com.cn/public/dist/#/aiRestful/aiRestfulApi?api=${encodeURIComponent('你自定义的api地址')}&method=${API的请求方式}&paramArr=${encodeURIComponent('["param1=value1", "param2=value2"]')}&headerArr=${encodeURIComponent('["header1=value1"]')}&contentType=${API的请求参数格式}&ColaKey=${您的ColaKey}`;
1

以上参数说明:

序号 参数 是否必须 说明
1 api 您的自定义API,这个是必须传入的, 且需要进行encodeURIComponent处理
2 ColaKey 您的ColaKey,是一个合法性校验值,建议传入, 如果不传入用户将需要登录,传入后就可以不登录直接使用“AI生成“
3 method 您的自定义API的请求方式,可以传入值是: get、post、put、delete、options、patch
4 paramArr 您的自定义API的请求参数,是数组格式,且需要进行encodeURIComponent处理
5 headerArr 您的自定义API的header参数,是数组格式,且需要进行encodeURIComponent处理
6 contentType 您的自定义API的请求参数格式,可以传入值是: json、xml、x-www-form-urlencoded、plain、html

# 2、接入案例

我现在要为自定义的API(http://testapi/v1)配置AiRestful功能,该自定义API是post请求的,参数有两个.分别是name=lisi、age=20,请求参数格式是json格式,那么就需要这样配置跳转链接:

// 这个是原代码,请注意api、headerArr、paramArr参数是需要encodeURIComponent的,否则会乱码
let aiRestfulUrl = `https://luckycola.com.cn/public/dist/#/aiRestful/aiRestfulApi?api=${encodeURIComponent('http://testapi/v1')}&method=post&paramArr=${encodeURIComponent('["name=lisi", "age=20"]')}&contentType=json&ColaKey=xsnjxnshxsh`;
1
2

注意: api、headerArr、paramArr参数是需要encodeURIComponent的,否则会乱码! 注意: api、headerArr、paramArr参数是需要encodeURIComponent的,否则会乱码! 注意: api、headerArr、paramArr参数是需要encodeURIComponent的,否则会乱码!

// 这个是完成encodeURIComponent后的url
let aiRestfulUrl = 'https://luckycola.com.cn/public/dist/#/aiRestful/aiRestfulApi?api=http%3A%2F%2Ftestapi%2Fv1&method=post&paramArr=%5B%22name%3Dlisi%22%2C%20%22age%3D20%22%5D&contentType=json&ColaKey=xsnjxnshxsh';
1
2

# 四、注意点

您的ColaKey参数必须有效,否则无法正常使用!

注意!!!: 如果您还没有ColaKey,请先请前往luckycola官网[个人中心]获取 luckycola官网地址:http(s): //luckycola.com.cn/ (opens new window)

Last Updated: 12/15/2023, 12:31:32 PM