📷 QR Share System - 第三方 API 接入文档

1概览

本系统提供 HTTP API,允许第三方系统/小程序/App 直接上传图片(拍照/签名),并获取图片查看网址和二维码。

核心流程

流程图第三方系统 ──上传图片──▶ QR Share API
                                │
                                ▼
                         返回 view_url (查看网址)
                                │
                                ▼
                  第三方根据 view_url 生成二维码
                                │
                                ▼
                     用户扫码 → 打开查看页 → 预览/下载

接口列表

当前可用项目

⚠️ 以上 access_key 是调用上传接口的身份凭证,请妥善保管,不要泄露到前端代码中。

2认证方式

本系统使用 access_key 作为项目身份凭证,无需 token 或 OAuth。

获取 access_key

1. 登录后台管理 → 项目管理 → 新建/编辑项目
2. 系统会自动生成 16 位 access_key
3. 在项目编辑页底部「第三方 API 接入说明」卡片中复制

使用方式

将 access_key 作为请求参数传递:

• POST 请求:放在表单字段或JSON字段中
• GET 请求:放在URL查询参数中

3图片上传接口 POST

上传拍照或签名图片,返回图片查看网址、原图直链、二维码URL。

接口地址

URLhttps://qrshare.nsjia.cn/api/upload.php

支持两种上传方式:

方式1: multipart/form-data 文件上传 推荐

适合前端表单、移动端WebView、原生HTTP客户端直接上传二进制文件。

请求示例

HTTPPOST https://qrshare.nsjia.cn/api/upload.php HTTP/1.1
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary

------WebKitFormBoundary
Content-Disposition: form-data; name="access_key"

1a2b3c4d5e6f7890
------WebKitFormBoundary
Content-Disposition: form-data; name="img_type"

photo
------WebKitFormBoundary
Content-Disposition: form-data; name="file"; filename="photo.jpg"
Content-Type: image/jpeg

(二进制图片数据)
------WebKitFormBoundary--

方式2: application/json Base64 上传

适合服务端调用、无法使用multipart的场景。将图片转为Base64字符串后以JSON提交。

请求示例

JSONPOST https://qrshare.nsjia.cn/api/upload.php HTTP/1.1
Content-Type: application/json

{
  "access_key": "1a2b3c4d5e6f7890",
  "img_type": "photo",
  "filename": "photo.jpg",
  "file_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASA..."
}

成功响应

JSON · 200{
  "success": true,
  "code": 0,
  "msg": "上传成功",
  "data": {
    "image_id": 123,
    "img_type": "photo",
    "view_url": "https://qrshare.nsjia.cn/view/?k=abc123def456ghi789",
    "image_url": "https://qrshare.nsjia.cn/uploads/2026/08/xxx.jpg",
    "qrcode_url": "https://qrshare.nsjia.cn/api/qrcode.php?k=abc123def456ghi789&s=300",
    "link_key": "abc123def456ghi789",
    "project_id": 1,
    "project_name": "示例项目",
    "upload_time": "2026-08-12 18:00:00"
  }
}

4链接预占接口(上传前生成二维码) POST

适用场景:需要在图片上传之前就知道该图片未来的查看链接与二维码——先拿到二维码,把它合成/打印到图片上,再上传合成后的图片。上传成功后,预先生成的二维码扫码即可打开该图片。

接口地址

URLhttps://qrshare.nsjia.cn/api/reserve_link.php

支持 application/json 与 application/x-www-form-urlencoded / multipart/form-data。

请求示例

JSONPOST https://qrshare.nsjia.cn/api/reserve_link.php HTTP/1.1
Content-Type: application/json

{
  "access_key": "1a2b3c4d5e6f7890",
  "img_type": "photo"
}

cURLcurl -X POST https://qrshare.nsjia.cn/api/reserve_link.php \
  -d "access_key=1a2b3c4d5e6f7890" \
  -d "img_type=photo"

成功响应

JSON · 200{
  "success": true,
  "code": 0,
  "msg": "链接预占成功",
  "data": {
    "link_key": "abc123def456ghi789abc123def456ghi7",
    "view_url": "https://qrshare.nsjia.cn/view/?k=abc123def456ghi789abc123def456ghi7",
    "qrcode_url": "https://qrshare.nsjia.cn/api/qrcode.php?k=abc123def456ghi789abc123def456ghi7&s=300",
    "qrcode_big": "https://qrshare.nsjia.cn/api/qrcode.php?k=abc123def456ghi789abc123def456ghi7&s=500",
    "img_type": "photo",
    "project_id": 1,
    "project_name": "示例项目",
    "status": "pending"
  }
}

5图片查询接口 GET

根据 link_key 或 image_id 查询图片详情,包含查看页配置(可用于第三方自定义展示)。

接口地址

URLhttps://qrshare.nsjia.cn/api/image_info.php

参数(二选一)

请求示例

HTTPGET https://qrshare.nsjia.cn/api/image_info.php?link_key=abc123def456ghi789

成功响应

JSON · 200{
  "success": true,
  "code": 0,
  "msg": "ok",
  "data": {
    "image": {
      "id": 123,
      "project_id": 1,
      "img_type": "photo",
      "img_type_cn": "照片",
      "create_time": "2026-08-12 18:00:00",
      "link_key": "abc123def456ghi789",
      "status": "ready"
    },
    "project": {
      "id": 1,
      "name": "示例项目",
      "access_key": "1a2b3c4d5e6f7890",
      "status_text": "运行中",
      "end_time": null,
      "is_expired": false,
      "can_view": true
    },
    "urls": {
      "view_url": "https://qrshare.nsjia.cn/view/?k=abc123def456ghi789",
      "image_url": "https://qrshare.nsjia.cn/uploads/2026/08/xxx.jpg",
      "qrcode_url": "https://qrshare.nsjia.cn/api/qrcode.php?k=abc123def456ghi789&s=300",
      "qrcode_big": "https://qrshare.nsjia.cn/api/qrcode.php?k=abc123def456ghi789&s=500"
    },
    "view_config": {
      "title": "图片预览",
      "logo": "",
      "subtitle": "长按图片或点击下方按钮可下载",
      "footer": "© QR Share System",
      "theme_color": "#4A90D9",
      "bg_image": "",
      "header_text": "",
      "show_info": true,
      "show_download": true
    }
  }
}

6二维码生成接口 GET

直接返回二维码 PNG 图片,可作为 <img> 的 src 使用。

接口地址

URLhttps://qrshare.nsjia.cn/api/qrcode.php

参数

使用示例

HTML
<img src="https://qrshare.nsjia.cn/api/qrcode.php?ak=a1b2c3d4e5f6g7h8&s=300"
     width="300" height="300" alt="扫码上传图片">


<img src="https://qrshare.nsjia.cn/api/qrcode.php?k=abc123def456ghi789&s=300"
     width="300" height="300" alt="扫码查看图片">


<img src="https://qrshare.nsjia.cn/api/qrcode.php?text=https%3A%2F%2Fexample.com" alt="二维码">

7链接重置接口 POST 需管理员登录

重置图片的访问链接,旧链接立即失效,返回新链接。适合图片泄露后重新加密。

接口地址

URLhttps://qrshare.nsjia.cn/api/reset_link.php

参数

成功响应

JSON{
  "success": true,
  "new_link": "https://qrshare.nsjia.cn/view/?k=newkey1234567890abcdef"
}

8代码示例

PHP - cURL 文件上传

PHP<?php
$ch = curl_init('https://qrshare.nsjia.cn/api/upload.php');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => [
        'access_key' => '1a2b3c4d5e6f7890',
        'img_type'   => 'photo',
        'file'       => new CURLFile('/path/to/photo.jpg', 'image/jpeg'),
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result['success']) {
    echo "查看网址: " . $result['data']['view_url'] . "\n";
    echo "二维码URL: " . $result['data']['qrcode_url'] . "\n";
    echo "原图URL: " . $result['data']['image_url'] . "\n";
} else {
    echo "上传失败: " . $result['msg'] . "\n";
}

PHP - Base64 上传

PHP<?php
$imagePath = '/path/to/photo.jpg';
$base64 = 'data:image/jpeg;base64,' . base64_encode(file_get_contents($imagePath));

$payload = [
    'access_key'  => '1a2b3c4d5e6f7890',
    'img_type'    => 'signature',
    'filename'    => 'sign.png',
    'file_base64' => $base64,
];

$ch = curl_init('https://qrshare.nsjia.cn/api/upload.php');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

JavaScript - fetch 文件上传

JavaScriptconst formData = new FormData();
formData.append('access_key', '1a2b3c4d5e6f7890');
formData.append('img_type', 'photo');
formData.append('file', fileInput.files[0]);

const res = await fetch('https://qrshare.nsjia.cn/api/upload.php', {
    method: 'POST',
    body: formData
});
const result = await res.json();

if (result.success) {
    console.log('查看网址:', result.data.view_url);
    console.log('二维码URL:', result.data.qrcode_url);
    // 显示二维码
    qrImg.src = result.data.qrcode_url;
} else {
    alert('上传失败: ' + result.msg);
}

Python - requests 上传

Pythonimport requests

url = 'https://qrshare.nsjia.cn/api/upload.php'
files = {'file': ('photo.jpg', open('/path/to/photo.jpg', 'rb'), 'image/jpeg')}
data = {
    'access_key': '1a2b3c4d5e6f7890',
    'img_type': 'photo',
}
response = requests.post(url, files=files, data=data)
result = response.json()

if result['success']:
    print(f"查看网址: {result['data']['view_url']}")
    print(f"二维码URL: {result['data']['qrcode_url']}")
else:
    print(f"上传失败: {result['msg']}")

Java - OkHttp 上传

JavaOkHttpClient client = new OkHttpClient();

RequestBody formBody = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("access_key", "1a2b3c4d5e6f7890")
    .addFormDataPart("img_type", "photo")
    .addFormDataPart("file", "photo.jpg",
        RequestBody.create(new File("/path/to/photo.jpg"),
            MediaType.parse("image/jpeg")))
    .build();

Request request = new Request.Builder()
    .url("https://qrshare.nsjia.cn/api/upload.php")
    .post(formBody)
    .build();

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

C# - HttpClient 上传

C#using var client = new HttpClient();
using var content = new MultipartFormDataContent();
content.Add(new StringContent("1a2b3c4d5e6f7890"), "access_key");
content.Add(new StringContent("photo"), "img_type");

using var fs = File.OpenRead("/path/to/photo.jpg");
content.Add(new StreamContent(fs), "file", "photo.jpg");

var response = await client.PostAsync("https://qrshare.nsjia.cn/api/upload.php", content);
var json = await response.Content.ReadAsStringAsync();
Console.WriteLine(json);

微信小程序 - wx.uploadFile

JavaScriptwx.uploadFile({
  url: 'https://qrshare.nsjia.cn/api/upload.php',
  filePath: tempImagePath,  // wx.chooseImage 拿到的临时路径
  name: 'file',
  formData: {
    access_key: '1a2b3c4d5e6f7890',
    img_type: 'photo'
  },
  success: function(res) {
    var result = JSON.parse(res.data);
    if (result.success) {
      console.log('查看网址:', result.data.view_url);
      console.log('二维码URL:', result.data.qrcode_url);
    } else {
      wx.showToast({ title: result.msg, icon: 'none' });
    }
  }
});

9错误码

10常见问题

Q1: 上传后如何生成二维码?

两种方式:

• 直接使用:把返回的 data.qrcode_url 作为 <img> 的 src 即可
• 自己生成:用 data.view_url 作为内容,通过第三方二维码生成库生成

Q2: 用户扫码后看到什么?

扫码后会打开图片预览页(view_url),页面应用项目配置的查看页样式(标题/LOGO/背景/主题色),支持:

• 高清原图在线预览
• 点击下载原图(PC)/长按保存(移动端)
• 复制分享链接
• PC端点击图片放大查看

Q3: 图片会过期吗?

取决于项目配置:

• 项目设置了 end_time 且已过期 → 上传接口拒绝新上传
• 过期策略 expire_policy=1 → 已上传图片仍可查看
• 过期策略 expire_policy=0 → 已上传图片禁止查看

Q4: 图片大小限制?

• 单张图片最大 10MB(服务端限制)
• Base64 方式建议 < 8MB(避免 Base64 字符串过大)
• 服务端会自动压缩:宽度超过 1920px 等比缩放,JPEG 质量 85%

Q5: 跨域(CORS)支持?

已开启 Access-Control-Allow-Origin: *,支持浏览器、小程序、App WebView 直接调用。

Q6: 如何批量上传?

当前接口为单张上传,批量场景请循环调用。建议并发不超过 3 个,避免服务器压力。

Q7: 如何删除图片?

删除图片需登录后台管理 → 图片管理 → 选择图片删除。暂未提供删除API。

Q8: access_key 泄露了怎么办?

联系管理员在后台停用项目或重建项目,旧 access_key 立即失效。