草料二维码 自定义样式二维码API调用PHP实例

草料二维码相信大家都有用到,这个平时用来解码和生码的比较多,草料二维码实际上还支持很多更丰富的二维码相关功能,比如这篇文章提到的 私有样式二维码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:

效果

%title插图%num

官方调用文档

以下内容引用官方调用文档:我的样式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编码

file

调用示例

在草料后台,【标签样式】目录下选择之前保存的我的标签样式,进入标签样式详情页,点击【更多】-【开通标签API】,开启调用。

如果没有样式,可以先创建样式。标签制作页链接:https://cli.im/label

file

开通标签API对接,即可获取到APIkey和API_secret。还可设置调用范围,可选择公开或者指定IP域名可调用。

file

© 版权声明
THE END
喜欢就支持一下吧
点赞0 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容