图片

这篇教程是零代码进行的coze插件开发。对于没有代码经验的同学就比较友好。主要是基于API服务,实现coze插件功能。

一 申请API Key

我们要想通过API获取汇率,那么就需要获取API接口对应的Key。首先打开汇率API的网址。这里我使用的是ExchangeRate-API。

https://www.exchangerate-api.com/

1.1 注册账号

没有注册需要先注册,这里填写你的邮箱,然后点击GetFree Key按钮。

图片

输入密码后,点击接受条款并注册账号

图片

1.2 激活账号

然后打开刚刚注册使用的邮箱,点击链接激活

图片

1.3 获取API Key

激活后,会自动跳转到ExchangeRate-API页面,此时会看到你的API Key,以及请求示例。

图片

这里同时还说明,每个月有1500次的免费请求。

1.4 接口信息

这里我们就可以了解到请求的API接口信息:


https://v6.exchangerate-api.com/v6/YOUR-API-KEY/latest/USD

  • 将 YOUR-API-KEY 替换为你的密钥

  • 将 USD 替换为你想查询的基础货币代码(如CNY、EUR、JPY)

可以测试一下:可以看到返回的货币还是挺多的。

图片

这里还有一个是查询指定币种的汇率。

API接口:https://v6.exchangerate-api.com/v6/YOUR-API-KEY/pair/EUR/GBP

这个就是查询EUR,转GBP的汇率。

图片

二 coze平台创建插件

2.1 新建插件

在coze的工作空间中,点开资源库,然后新建一个插件。

图片

输入插件名称和描述,创建方式选择第一种:基于已有服务器创建。

插件名称:外汇汇率查询

插件描述:根据基础货币获取实时汇率,并支持金额换算

图片

然后填入插件URL,这里我们填入:https://v6.exchangerate-api.com/v6

授权方式选择:不需要授权。

图片

2.2 创建工具-查询所有币种汇率

然后我们要创建工具。

图片

工具名称:exchange_rate_query

工具描述:汇率查询

图片

点击确定后,进入这个编辑工具页面

图片

1.设置工具路径

编辑工具路径:

v6后面补:/{key}/latest/{base_code}

请求方式:GET请求。

图片

2.设置输入参数

配置输入参数:一个是API Key,一个是货币代号。USD、CNY等

图片

货币代号:

{    "reason": "查询成功",    "result": {        "list": [            {                "name": "美元",                "code": "USD"            },            {                "name": "人民币",                "code": "CNY"            },            {                "name": "日元",                "code": "JPY"            },            {                "name": "欧元",                "code": "EUR"            },            {                "name": "英镑",                "code": "GBP"            },            {                "name": "韩元",                "code": "KRW"            },            {                "name": "港元",                "code": "HKD"            },            {                "name": "澳大利亚元",                "code": "AUD"            },            {                "name": "加拿大元",                "code": "CAD"            },            {                "name": "瑞士法郎",                "code": "CHF"            },            {                "name": "阿联酋迪拉姆",                "code": "AED"            },            {                "name": "阿尔巴尼亚列克",                "code": "ALL"            },            {                "name": "亚美尼亚德拉姆",                "code": "AMD"            },            {                "name": "荷属安的列斯盾",                "code": "ANG"            },            {                "name": "安哥拉宽扎",                "code": "AOA"            },            {                "name": "阿根廷比索",                "code": "ARS"            },            {                "name": "阿塞拜疆马纳特",                "code": "AZN"            },            {                "name": "巴巴多斯元",                "code": "BBD"            },            {                "name": "孟加拉塔卡",                "code": "BDT"            },            {                "name": "保加利亚列弗",                "code": "BGN"            },            {                "name": "巴林第纳尔",                "code": "BHD"            },            {                "name": "布隆迪法郎",                "code": "BIF"            },            {                "name": "百慕大元",                "code": "BMD"            },            {                "name": "文莱元",                "code": "BND"            },            {                "name": "玻利维亚币",                "code": "BOB"            },            {                "name": "巴西雷阿尔",                "code": "BRL"            },            {                "name": "巴哈马元",                "code": "BSD"            },            {                "name": "博茨瓦纳普拉",                "code": "BWP"            },            {                "name": "白俄罗斯卢布",                "code": "BYN"            },            {                "name": "伯利兹元",                "code": "BZD"            },            {                "name": "智利比索",                "code": "CLP"            },            {                "name": "哥伦比亚比索",                "code": "COP"            },            {                "name": "哥斯达黎加科郎",                "code": "CRC"            },            {                "name": "古巴比索",                "code": "CUP"            },            {                "name": "佛得角埃斯库多",                "code": "CVE"            },            {                "name": "捷克克朗",                "code": "CZK"            },            {                "name": "吉布提法郎",                "code": "DJF"            },            {                "name": "丹麦克朗",                "code": "DKK"            },            {                "name": "多米尼加比索",                "code": "DOP"            },            {                "name": "阿尔及利亚第纳尔",                "code": "DZD"            },            {                "name": "埃及镑",                "code": "EGP"            },            {                "name": "埃塞俄比亚比尔",                "code": "ETB"            },            {                "name": "斐济元",                "code": "FJD"            },            {                "name": "格鲁吉亚拉里",                "code": "GEL"            },            {                "name": "加纳塞地",                "code": "GHS"            },            {                "name": "冈比亚达拉西",                "code": "GMD"            },            {                "name": "几内亚法郎",                "code": "GNF"            },            {                "name": "危地马拉格查尔",                "code": "GTQ"            },            {                "name": "洪都拉斯伦皮拉",                "code": "HNL"            },            {                "name": "克罗地亚库纳",                "code": "HRK"            },            {                "name": "海地古德",                "code": "HTG"            },            {                "name": "匈牙利福林",                "code": "HUF"            },            {                "name": "印尼盾",                "code": "IDR"            },            {                "name": "以色列新谢克尔",                "code": "ILS"            },            {                "name": "印度卢比",                "code": "INR"            },            {                "name": "伊拉克第纳尔",                "code": "IQD"            },            {                "name": "伊朗里亚尔",                "code": "IRR"            },            {                "name": "冰岛克朗",                "code": "ISK"            },            {                "name": "牙买加元",                "code": "JMD"            },            {                "name": "约旦第纳尔",                "code": "JOD"            },            {                "name": "肯尼亚先令",                "code": "KES"            },            {                "name": "吉尔吉斯斯坦索姆",                "code": "KGS"            },            {                "name": "柬埔寨瑞尔",                "code": "KHR"            },            {                "name": "科威特第纳尔",                "code": "KWD"            },            {                "name": "开曼群岛元",                "code": "KYD"            },            {                "name": "哈萨克斯坦坚戈",                "code": "KZT"            },            {                "name": "老挝基普",                "code": "LAK"            },            {                "name": "黎巴嫩镑",                "code": "LBP"            },            {                "name": "斯里兰卡卢比",                "code": "LKR"            },            {                "name": "莱索托洛蒂",                "code": "LSL"            },            {                "name": "利比亚第纳尔",                "code": "LYD"            },            {                "name": "摩洛哥迪拉姆",                "code": "MAD"            },            {                "name": "摩尔多瓦列伊",                "code": "MDL"            },            {                "name": "马其顿第纳尔",                "code": "MKD"            },            {                "name": "缅甸缅元",                "code": "MMK"            },            {                "name": "澳门帕塔卡",                "code": "MOP"            },            {                "name": "毛里求斯卢比",                "code": "MUR"            },            {                "name": "马拉维客瓦查",                "code": "MWK"            },            {                "name": "墨西哥比索",                "code": "MXN"            },            {                "name": "马来西亚令吉",                "code": "MYR"            },            {                "name": "纳米比亚元",                "code": "NAD"            },            {                "name": "尼日利亚奈拉",                "code": "NGN"            },            {                "name": "尼加拉瓜新科多巴",                "code": "NIO"            },            {                "name": "挪威克朗",                "code": "NOK"            },            {                "name": "尼泊尔卢比",                "code": "NPR"            },            {                "name": "新西兰元",                "code": "NZD"            },            {                "name": "阿曼里亚尔",                "code": "OMR"            },            {                "name": "巴拿马巴波亚",                "code": "PAB"            },            {                "name": "秘鲁索尔",                "code": "PEN"            },            {                "name": "菲律宾比索",                "code": "PHP"            },            {                "name": "巴基斯坦卢比",                "code": "PKR"            },            {                "name": "波兰兹罗提",                "code": "PLN"            },            {                "name": "巴拉圭瓜拉尼",                "code": "PYG"            },            {                "name": "卡塔尔里亚尔",                "code": "QAR"            },            {                "name": "罗马尼亚新列伊",                "code": "RON"            },            {                "name": "塞尔维亚第纳尔",                "code": "RSD"            },            {                "name": "俄罗斯卢布",                "code": "RUB"            },            {                "name": "卢旺达法郎",                "code": "RWF"            },            {                "name": "沙特里亚尔",                "code": "SAR"            },            {                "name": "塞舌尔卢比",                "code": "SCR"            },            {                "name": "苏丹镑",                "code": "SDG"            },            {                "name": "瑞典克朗",                "code": "SEK"            },            {                "name": "新加坡元",                "code": "SGD"            },            {                "name": "索马里先令",                "code": "SOS"            },            {                "name": "斯威士兰埃马兰吉尼",                "code": "SZL"            },            {                "name": "泰国泰铢",                "code": "THB"            },            {                "name": "土库曼斯坦马纳特",                "code": "TMT"            },            {                "name": "突尼斯第纳尔",                "code": "TND"            },            {                "name": "土耳其新里拉",                "code": "TRY"            },            {                "name": "特立尼达和多巴哥元",                "code": "TTD"            },            {                "name": "新台币",                "code": "TWD"            },            {                "name": "坦桑尼亚先令",                "code": "TZS"            },            {                "name": "乌克兰格里夫纳",                "code": "UAH"            },            {                "name": "乌干达先令",                "code": "UGX"            },            {                "name": "乌拉圭比索",                "code": "UYU"            },            {                "name": "乌兹别克斯坦索姆",                "code": "UZS"            },            {                "name": "委内瑞拉玻利瓦尔",                "code": "VES"            },            {                "name": "越南盾",                "code": "VND"            },            {                "name": "中非金融合作法郎",                "code": "XAF"            },            {                "name": "东加勒比元",                "code": "XCD"            },            {                "name": "非洲金融共同体法郎",                "code": "XOF"            },            {                "name": "太平洋金融共同体法郎",                "code": "XPF"            },            {                "name": "也门里亚尔",                "code": "YER"            },            {                "name": "南非兰特",                "code": "ZAR"            },            {                "name": "赞比亚克瓦查",                "code": "ZMW"            }        ]    },    "error_code": 0}
3.设置输出参数

因为输出参数有点多

图片

然后可以看到解析出对应的参数,根据情况进行删减。

图片

  1. 测试工具

设置好以上数据,就可以试运行了。

图片

可以看到运行结果,同时把这个测试保存为工具示使用例。

图片

2.3 添加工具-查询指定币种汇率

上面的工具是查询所有的币种的汇率,其实也可以查询指定币种的汇率。

这里我们使用 https://v6.exchangerate-api.com/v6/YOUR-API-KEY/pair/EUR/GBP,来查询指定币种的汇率

比如示例中就是查询EUR转为GBP的汇率。

图片

我们回到刚才的插件中,再创建一个工具。

图片

工具名称:exchange_rate_pair

工具描述:查询指定币种的汇率

图片

1.设置工具路径

补全:/{key}/pair/{base_currency}/{target_currency}

请求方式为:GET请求

图片

2.设置输入参数

参数之类需要3个,一个是API Key,一个是基础货币,一个是目标货币。传入方式选择Path

key:就是API Key,必填

base_currency:基础货币(ISO代码)

target_currency:目标货币(ISO代码)

图片

3.设置输出参数

可以看到接口返回的数据参数还挺多。不想手写添加,可以自动解析一下。

图片

解析出的这些参数,可以自己进行删除和保留。

图片

这里我只保留了4个参数,并设置了参数描述。

图片

4.测试工具

这里测试一下美元对人民币

图片

2.4 添加工具 - 指定币种金额换算

我们可以使用这个API接口,来进行金额换算。比如1000元人民币,可以兑换多少美元。

API接口:https://v6.exchangerate-api.com/v6/YOUR-API-KEY/pair/EUR/GBP/AMOUNT

图片

工具名称:exchange_rate_calculate

工具描述:指定币种,指定金额的外币计算。

图片

1.设置工具路径

补全:/{key}/pair/{base_currency}/{target_currency}/{amount}

请求方式为:GET请求

图片

2.设置输入参数

参数之类需要3个,一个是API Key,一个是基础货币,一个是目标货币,还有金额。传入方式选择Path

key:就是API Key,必填

base_currency:基础货币(ISO代码)

target_currency:目标货币(ISO代码)

amount:金额

图片

3.设置参数

看一下请求结果:

图片

然后自动解析一下输出参数,根据实际情况,可以删减一些。

图片

4.测试工具

100美金,可以兑换714人民币。

图片

三 发布&上架

3.1 发布插件

这里我们一个插件,含3个工具。

图片

如果想上架插件商店,那么要修改插件图标。然后发布。

发布后,自己就可以使用了,添加插件的时候在资源库工具中查找插件名称。

图片

3.2 上架商店

发布后,自己就可以使用了,如果还想给别人用,可以上架插件商店。

图片

填写好信息,提交,等待审核。

图片

审核后,会有就消息通知。然后打开通知里的链接就可以看见插件详情了。

图片

在插件商店里里,搜索外汇汇率,也可以看见自己的插件。

图片


图片

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐