一、产品介绍

可部署至「本地服务器」或「专有云服务器」的WEB API服务，支持二维码在线生成服务，在专有网络环境下部署应用，保障数据私密性，提供一键启动软件部署包私有化方案。详情可点击: https://www.juhe.cn/papi/qrcode 进行了解。

二、使用教程

下载部署包

通过聚合官方网站下载对应的MacOS版本私有部署包(*目前暂支持64位系统)，比如下载的压缩包版本为: jqrcode-1.0.0-macos11-x86_64.tar.gz，将压缩包上传至服务器。
进入压缩包所在的文件目录，通过tar命令解压，比如所在目录为: /Users/juhe/Downloads/

# 进入目录
cd /Users/juhe/Downloads/

# 解压
tar zxvf jqrcode-1.0.0-macos11-x86_64.tar.gz

# 进入程序目录
cd jqrcode-1.0.0-macos11-x86_64

解压私有部署包后，进入程序目录，可以看到如下文件:

文件目录介绍:
-- docs/index.html 为接口调用基本说明文档
-- server 为服务主程序

启动API服务

1. 进入程序目录

 cd jqrcode-1.0.0-x86_64

2. 启动服务

 ./server

3. 服务默认的端口为8369，如果该端口被占用或需自定义端口，启动时可以使用--port参数指定端口，例如:

./server --port 8368

4. 如需系统后台不挂断地运行，可以使用nohup命令启动服务，例如:

nohup ./server 2>&1 &

您也可以使用其他的比如supervisor等管理工具实现。

如启动结果如下图显示，说明启动服务成功!

调用API服务

本地API服务启动成功后，您即可通过提供的API地址进行接口请求了。

比如上一步示例启动的服务 (具体服务的IP和端口以实际为准)，您可以通过:

接口文档地址

(浏览器访问,查看完整接口文档说明)

http://127.0.0.1:8369/docs
或
http://10.0.49.15:8369/docs

接口请求地址

API接口地址:

http://127.0.0.1:8369/query
或
http://10.0.49.15:8369/query

API接口参数简易参照 (GET请求接口，进行调用):

API接口请求参数示例:

# 比如生成二维码内容为“juhe.cn”
http://10.0.49.15: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图片

*具体接口返回格式及说明，请参照接口文档