掌握 Coze 插件开发:一篇教程学会用 API 做汇率换算,附完整步骤(含上架)
API接口:https://v6.exchangerate-api.com/v6/YOUR-API-KEY/pair/EUR/GBP/AMOUNT。这里我们使用 https://v6.exchangerate-api.com/v6/YOUR-API-KEY/pair/EUR/GBP。API接口:https://v6.exchangerate-api.com/v6/YOUR-API-KEY/pair

这篇教程是零代码进行的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.设置输出参数
因为输出参数有点多

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

-
测试工具
设置好以上数据,就可以试运行了。

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

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 上架商店
发布后,自己就可以使用了,如果还想给别人用,可以上架插件商店。

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

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

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



更多推荐

所有评论(0)