草料二维码相信大家都有用到,这个平时用来解码和生码的比较多,草料二维码实际上还支持很多更丰富的二维码相关功能,比如这篇文章提到的 私有样式二维码API调用。
此功能可以实现使用API KEY调用自己草料二维码账号下设置好的标签样式,在别的地方使用API生成你自己样式的二维码。借助草料二维码内的多套公共模板和可视化样式创建,实现多个场景的“二维码自由”,目前处于Beta内测期间,API调用根据IP秒级并发60次,如需更高并发次数,可前往草料官方社区反馈。现在开通API的用户可长期免费调用。
PHP调用Demo
官方调用文档可以看下文,先贴一个在PHP页面中调用实例:
这里的Demo由ChatGPT生成,这里也同步贴一下我向ChatGPT提需求的过程,“AI提示词”
我这里除了APIkey和APIsecret外,仅仅定义了两个参数,cliD二维码内容和cliF1字段(就是第一个字段,因为我这个二维码就定义了一个自定义文字字段),你使用的话还需要修改cliT二维码样式id。如果你的样式中有更多参数,也需要加一下。
帮我写一个php api调用代码。我会给你一些信息。
api有两个参数,
我们在php代码中定义:cliD=二维码内容,cliF1=群名称
我的账户是APIkey和APIsecret
首先我们使用md5加密 得到签名sign,加密内容为:
api_key=我的APIkey(APIkey)&cliD=二维码内容(对于上边的变量)&cliF1=群名称(对于上边的变量)&cliT=D8&return_file=我的APIsecret(APIsecret)
得到一个32位小写的md5加密,然后拼接成最终的api链接:
https://open-api.cli.im/cli-open-platform-service/v1/labelStyle/createWithKey?api_key=我的APIkey(APIkey)&cliD=二维码内容(对于上边的变量)&cliF1=群名称(对于上边的变量)&cliT=D8&return_file=&sign=(上边加密的签名sign)
请你帮我定义。
Demo:
效果
官方调用文档
以下内容引用官方调用文档:我的样式API对接说明
调用方式
GET https: //open-api.cli.im/cli-open-platform-service/v1/labelStyle/createWithKey
请求参数
参数名称 |
是否必须 |
类型 |
说明 |
cliT |
是 |
string |
标签样式id,例如D10 |
cliD |
是 |
string |
二维码动态内容 |
api_key |
是 |
string |
用户账号api key |
sign |
是 |
string |
签名,生成方式见加签方式 |
return_file |
否 |
string |
返回类型,不传时返回二进制图片流,base64-返回base64编码 |
cliF,cliP |
否 |
string |
根据我的样式需要传入的动态字段,cliF表示普通文本字段,cliP表示图片字段,图片需要公网可访问静态地址,按照字段展示顺序排列,例如我的样式有4个字段,第二个为图片字段,其余为文本字段,传入参数为: cliF1=xx&cliP2=xx&cliF3=xx&cliF4=xx |
API调用根据IP秒级并发60次,如需更高并发次数,可 前往社区反馈
加签方式
1、将请求参数按照key的字典序排列,然后用&拼接成字符串,例如使用以下请求参数。
key |
value |
cliT |
D10 |
cliD |
测试数据单个制作标签 |
return_file |
|
cliP1 |
https://ncstatic.clewm.net/rsrc/2023/0331/11/823ace0e8a36e304ca8bfab683be6219.png |
cliF2 |
京海市第一人民医院 |
cliF3 |
Jinghai First People’s Hospital |
cliF4 |
王菲菲 |
cliF5 |
职务:助理护士 |
cliF6 |
科室:住院部 |
cliF7 |
编号:NO-GT-043 |
api_key |
CLb87ea759f877622c |
排序拼接后字符串为:
api_key=CLb87ea759f877622c&cliD=图片样式二维码&cliF2=京海市第一人民医院&cliF3=Jinghai First People's Hospital&cliF4=王菲菲&cliF5=职务:助理护士&cliF6=科室:住院部&cliF7=编号:NO-GT-043&cliP1=https://ncstatic.clewm.net/rsrc/2023/0331/11/823ace0e8a36e304ca8bfab683be6219.png&cliT=D11&return_file=
拼接系统提供的用户api secret到上述字符串最后,假设secret为ddb42b7299b90cb5e0fd6c41e154c15d,得到如下字符串:
api_key=CLb87ea759f877622c&cliD=图片样式二维码&cliF2=京海市第一人民医院&cliF3=Jinghai First People's Hospital&cliF4=王菲菲&cliF5=职务:助理护士&cliF6=科室:住院部&cliF7=编号:NO-GT-043&cliP1=https://ncstatic.clewm.net/rsrc/2023/0331/11/823ace0e8a36e304ca8bfab683be6219.png&cliT=D11&return_file=ddb42b7299b90cb5e0fd6c41e154c15d
将以上字符串进行md5加密,全部取小写,得到签名sign:
2f7ee4e4c678bde31a0345de23ea3d0e
返回参数
当return_file未传时,返回二进制图片
当return_file=base64时,返回base64图片编码
请求示例:
https://open-api.cli.im/cli-open-platform-service/v1/labelStyle/createWithKey?api_key=CLb87ea759f877622c&cliT=D11&cliD=图片样式二维码&cliP1=https://ncstatic.clewm.net/rsrc/2023/0331/11/823ace0e8a36e304ca8bfab683be6219.png&cliF2=京海市第一人民医院&cliF3=Jinghai First People's Hospital&cliF4=王菲菲&cliF5=职务:助理护士&cliF6=科室:住院部&sign=2f7ee4e4c678bde31a0345de23ea3d0e&return_file=&cliF7=编号:NO-GT-043
返回示例
当return_file未传时,返回以下图片二进制流
当return_file=base64时,返回以下图片的base64编码
调用示例
在草料后台,【标签样式】目录下选择之前保存的我的标签样式,进入标签样式详情页,点击【更多】-【开通标签API】,开启调用。
如果没有样式,可以先创建样式。标签制作页链接:https://cli.im/label
开通标签API对接,即可获取到APIkey和API_secret。还可设置调用范围,可选择公开或者指定IP域名可调用。
暂无评论内容