二维码生成与识别 API 结合之活动签到系统的设计与实现

引言

活动签到是各类会议、展览和社交活动中必不可少的环节。传统的签到方式常常繁琐且容易出错，因此，采用二维码技术进行签到已成为一种常见的解决方案。

本文将介绍一种利用二维码生成 API 和二维码识别 OCR 相结合的技术方案，用于构建高效、安全的活动签到系统。

设计思路

1. 生成唯一的活动签到二维码

使用二维码生成API，将活动的关键信息（如活动名称、地点、时间等）加密或编码到生成的二维码中。确保每个参与活动的用户都有唯一的签到二维码。

二维码生成API Java 接入代码：

OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "words=https://www.apispace.com%26image_url=%26is_gif=false");
Request request = new Request.Builder()
  .url("https://eolink.o.apispace.com/ercode/api/v1/forward/qr_code")
  .method("POST",body)
  .addHeader("X-APISpace-Token","")  // 可在APISpace 登录注册获取
  .addHeader("Authorization-Type","apikey")
  .addHeader("Content-Type","application/x-www-form-urlencoded")
  .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

其中 X-APISpace-Token 可在APISpace 登录注册获取

words ：扫描二维码后展示的内容
image_url：网络图片URL(words内容存在中文时，该参数不可用)
is_gif：传入image_url时可选，指定图片是否为gif图片

2. 展示二维码给参与用户

将生成的二维码以适当的方式展示给参与活动的用户。可以选择将二维码打印在纸质票据上，或者通过移动设备展示二维码。

3. 用户扫描二维码进行签到

参与活动的用户到达活动现场后，使用二维码识别OCR功能扫描二维码进行签到操作。二维码识别OCR 将扫描的二维码转换为可读的文本信息。

以下是二维码识别OCR 识别接入代码, Token 可在 APISpace 登录注册获取。

OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{"image":"","url":"https://www.apispace.com/assets/images/contactCode.png","pdf":"","pdf_page":""}");
Request request = new Request.Builder()
  .url("https://eolink.o.apispace.com/ocrbarcode/ocr/v1/barcode")
  .method("POST",body)
  .addHeader("X-APISpace-Token","")  // 可在APISpace 登录注册获取
  .addHeader("Authorization-Type","apikey")
  .addHeader("Content-Type","application/json")
  .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

其中字段的优先级是：image > url > pdf，当image字段存在时，url, pdf字段失效

image：图像数据，要求base64编码后大小不超过5M，最短边至少15px，最长边最大4096px，支持jpg/jpeg/png/bmp格式 ;
url：图片url，url长度不超过1024字节，url对应的图片base64编码后大小不超过5M，最短边至少15px，最长边最大4096px，支持jpg/jpeg/png/bmp格式 ;
pdf：pdf文件字节流的base64编码，要求base64编码后大小不超过5M，最短边至少15px，最长边最大4096px ;
pdf_page：使用pdf文件时，需要填对应识别的页码