一、产品介绍
可部署至「本地服务器」或「专有云服务器」的WEB API服务,支持二维码在线生成服务,在专有网络环境下部署应用,保障数据私密性,提供一键启动软件部署包私有化方案。详情可点击: https://www.juhe.cn/papi/qrcode 进行了解
二、使用教程
下载部署包
- 通过聚合官方网站下载对应的Windows版本私有部署包(*目前暂支持64位操作系统), 比如下载的压缩包版本为:
jqrcode-1.0.0-winx64.zip
- 解压私有部署包,进入目录后,可以看到如下文件
文件目录介绍:
-- docs/index.html 为接口调用基本说明文档
-- server.exe 为服务主程序
启动API服务
正常情况下,Windows下您可以直接双击打开部署包目录下的:server.exe
直接启动服务。
如果无反应,您可以尝试通过命令行方式启动服务:
1. Windows快捷键:Windows+R
, 然后输入cmd
打开终端运行窗口
2. 进入程序所在目录,执行下面命令(目录对应系统中部署程序实际所在完整目录路径),例如:
cd C:\papi\jqrcode-1.0.0-winx64
C:
3. 启动服务,输入server.exe
回车
server.exe
4. 服务默认的端口为8369
,如果该端口被占用或需自定义端口,启动时可以使用--port
参数指定端口,例如:
server.exe --port 8368
如下显示如下, 说明启动服务成功!
调用API服务
本地API服务启动成功后,您即可通过提供的API地址进行接口请求了。
比如上一步示例启动的服务 (具体服务的IP和端口以实际服务器为准)
,您可以通过:
接口文档地址
(浏览器访问,查看完整接口文档说明)
http://127.0.0.1:8369/docs
或
http://10.0.32.98:8369/docs
接口请求地址
API接口地址:
http://127.0.0.1:8369/query
或
http://10.0.32.98:8369/query
API接口参数简易参照 (GET请求接口,进行调用):
API接口请求参数示例:
# 比如生成二维码内容为“juhe.cn”
http://10.0.32.98:8369/query?text=juhe.cn
接口响应内容示例:
{
"code": 0,
"msg": "success",
"result": {
"base64_image": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEAAQMAAABmvDolAAAABlBMVEX///8AAABVwtN+AAABEUlEQVR42uzXsZGDMBAF0M8QEFKCS1FpUBqlUIJCAkb/ZgUjyzLowrtB/0cYv0ij3WWhKIry3zPyyOJWDDu68+cmUILjcVrcOtJA/rYpMJDEtOBFMnTERHqBe+BWeyvwK7Aq3AUq4KxNvPwQr9xd8bYO3s183PpQ7fZNgxRn70PlO+HZwEovwE7KzizeKJt/m0ABgNijzpO0zK64UQLp/zj1SO6pHgUuwA5wxvuDs7hyAjmw2gT6cAzAfOoJfHV7P6TvqOtx8GSQT/849Y4jE/gC2c57Pt7v/m2DtPN69HEAOoEa+GjmHgL3wJp5BJ9NTKDYeS1dsNpcr5fiZ4N8pTXA2YoQAgVQFEX5m/wEAAD//9gHkLZoCLprAAAAAElFTkSuQmCC"
}
}
二维码图片img标签使用方法:
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQAAAAEAAQMAAABmvDolAAAABlBMVEX///8AAABVwtN+AAABEUlEQVR42uzXsZGDMBAF0M8QEFKCS1FpUBqlUIJCAkb/ZgUjyzLowrtB/0cYv0ij3WWhKIry3zPyyOJWDDu68+cmUILjcVrcOtJA/rYpMJDEtOBFMnTERHqBe+BWeyvwK7Aq3AUq4KxNvPwQr9xd8bYO3s183PpQ7fZNgxRn70PlO+HZwEovwE7KzizeKJt/m0ABgNijzpO0zK64UQLp/zj1SO6pHgUuwA5wxvuDs7hyAjmw2gT6cAzAfOoJfHV7P6TvqOtx8GSQT/849Y4jE/gC2c57Pt7v/m2DtPN69HEAOoEa+GjmHgL3wJp5BJ9NTKDYeS1dsNpcr5fiZ4N8pTXA2YoQAgVQFEX5m/wEAAD//9gHkLZoCLprAAAAAElFTkSuQmCC">
您也可以将base64_image
图片内容base64decode后,保存为png图片
*具体接口返回格式及说明,请参照接口文档