PDF压缩 | 智汇阁API - API接口文档

基础信息

查看接口基本信息和返回格式

免责声明

本平台提供的API服务均来自互联网，可能包含生成式AI内容。所有返回内容仅供参考，平台不对内容的准确性、完整性、时效性或适用性做任何保证。使用者应自行判断并承担使用风险。

接口描述

可控制压缩级别、可设置期望输出大小的PDF压缩服务。

七日请求统计

本周总请求: - 日均: -

接口地址

https://api.mznzd.com/api/compresspdf

请求方式

返回方式

JSON默认返回格式，包含完整数据结构

返回预览

{
    "success": true,
    "content": "JVBERi0xLjQKJcOkw7zD...（base64编码的PDF文件内容）",
    "filename": "compressed_document.pdf",
    "size": 2097152,
    "compression_info": {
        "original_size": "5242880",
        "compressed_size": "2097152",
        "compression_ratio": "60.0%",
        "process_time": "3.45"
    }
}

计费标准

了解接口计费方式和套餐价格

接口类型

付费接口按调用次数计费

计费方式

每日前 1 次免费

超出后

普通用户 5 额度/次

QPS限制

普通用户

10 次/分钟

每分钟最多10次请求

会员用户

20 次/分钟

每分钟最多20次请求

每日请求次数

普通用户

1,000 次/天

每日最多1,000次请求，次日0点自动重置

会员用户

3,000 次/天

每日最多3,000次请求，满足大规模调用需求

计费规则

1 优先使用每日免费次数，超出部分按单次计费价格从账户点数扣除

2 当返回状态码为200的请求时才计费，恶意请求会被QPS规则限制访问

安全认证

了解接口的认证方式和访问凭证管理

认证方式

Header认证

通过 HTTP Header 传递认证信息

Authorization: Bearer {access_token}

Query认证

通过 URL 参数传递认证信息

?token={your_token}

Token 管理

登录账户

使用您的账号密码登录平台，获取用户凭证

获取 Token

即可查看你的 Token 密钥

更换 Token

进入个人中心，点击「更换Token」，系统将生成新的 Token 密钥

保存 Token

请妥善保管您的 Token 密钥，泄露时请立即更换

Token 怪谈

AccessToken 用于接口调用的身份标识，可公开在客户端使用

SecretKey 用于请求鉴权，严禁暴露在前端代码中，仅限服务端使用

安全建议

定期更换密钥，建议每 90 天更新一次
发现密钥泄露，请立即在个人中心「更换」该密钥
不要将密钥硬编码在代码中，使用环境变量存储

参数文档

了解接口的请求参数和响应字段说明

请求参数

参数名	类型	必填	默认值	可选值	说明
`token`	string	是	无	登录后显示你的请求token	接口请求唯一认证标识！
`file`	string	是			PDF文件。
`optimizeLevel`	string	是			压缩级别 1到10，值越大压缩率越高但质量可能下降。
`expectedOutputSize`	string	否			期望输出大小，如500KB, 2MB
`linearize`	string	否			是否线性化PDF用于快速Web查看
`normalize`	string	否			是否规范化PDF内容以获得更好的兼容性
`grayscale`	string	否			是否转换为灰度
`lineArt`	string	否			是否转换为高对比线条艺术
`lineArtThreshold`	string	否			线条艺术转换阈值0到100
`lineArtEdgeLevel`	string	否			边缘检测强度1到3

响应参数

字段名	类型	说明
`application/pdf`	string	200 OK,返回压缩后的PDF文件二进制数据

状态码

了解接口返回的状态码含义及处理方式

接口状态码

状态码	说明
`200`	请求成功

服务器状态码

状态码	说明
`500`	服务器错误
`501`	请求接口不存在
`502`	请求接口已下架
`503`	请求接口维护中
`504`	缺少请求token参数
`505`	请求token不存在
`506`	请求token已被封禁
`507`	请求token额度不足
`508`	今日请求token已达上限
`509`	请求ip不在token白名单内
`510`	请求token无权使用当前接口
`511`	接口请求频率过高，请稍后再试
`512`	该接口未开启在线测试功能
`513`	今日在线测试次数已达上限
`514`	今日该接口请求次数已达上限
`515`	该接口为会员专属接口，请携带会员token
`516`	该接口为会员专属接口，请开通会员
`517`	接口请求过于频繁，已被临时限制

在线测试

在线调试接口，实时查看响应结果

在线测试未开启

该接口暂未开启在线测试功能

示例代码

查看多种编程语言的接口调用示例

PHP
JavaScript
NodeJs
Python
Go
Java
C#
C
C++
易语言

PHP

/**
 * API请求DEMO-PHP
 * 
 * 本demo支持GET与POST请求。
 */

//你申请的token密钥
$API_TOKEN = 'YOUR_TOKEN';

//API接口地址
$API_URL = 'https://api.mznzd.com/api/compresspdf';

$get_post_data = array(
    'token' => 'YOUR_TOKEN',
    'file' => '参数值',
    'optimizeLevel' => '参数值',
    'expectedOutputSize' => '参数值',
    'linearize' => '参数值',
    'normalize' => '参数值',
    'grayscale' => '参数值',
    'lineArt' => '参数值',
    'lineArtThreshold' => '参数值',
    'lineArtEdgeLevel' => '参数值',
);

/*发起请求API接口:
第1个参数：API接口地址URL，跟上面的同名变量相对应，无需更改。
第2个参数：API接口参数数组，跟上面的同名变量相对应，无需更改。
第3个参数：请求协议（GET或POST），一般默认GET，部分接口需要POST请求，根据实际情况修改为POST即可。
 */
$resdata = api::send($API_URL, $get_post_data, 'POST');  //发起请求，注意这里要选择接口支持的协议，默认GET，可选POST

//打印请求结果
print($resdata);
///////////////你的业务代码可写在这里处理API返回的数据

/**
 * API请求类
 */
class api
{
    public static function send($API_URL, $get_post_data, $type)
    {
        $get_post_data = http_build_query($get_post_data);
        $res = self::send_curl($API_URL, $type, $get_post_data, null);
        return $res;
    }
    //封装好的CURL请求函数,支持POST|GET
    public static function send_curl($API_URL, $type, $get_post_data)
    {
        $ch = curl_init();
        if ($type == 'POST') {
            curl_setopt($ch, CURLOPT_URL, $API_URL);
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $get_post_data);
        } elseif ($type == 'GET') {
            curl_setopt($ch, CURLOPT_URL, $API_URL . '?' . $get_post_data);
        }
        curl_setopt($ch, CURLOPT_REFERER, $API_URL);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
        $resdata = curl_exec($ch);
        curl_close($ch);
        return $resdata;
    }
}

JavaScript

/**
 * API请求DEMO-JavaScript
 * 
 * 本demo支持GET与POST请求。
 */

 //jQuery-Ajax
$.ajax({
    url: 'https://api.mznzd.com/api/compresspdf',
    data: {
        token: 'YOUR_TOKEN',
        file: '参数值',
        optimizeLevel: '参数值',
        expectedOutputSize: '参数值',
        linearize: '参数值',
        normalize: '参数值',
        grayscale: '参数值',
        lineArt: '参数值',
        lineArtThreshold: '参数值',
        lineArtEdgeLevel: '参数值',
    },
    type: 'POST', //请求协议（GET或POST），一般默认GET，部分接口需要POST请求，根据实际情况修改为POST即可。
    dataType: 'json',
    success: function(data) {
        console.log(data); //请求成功，输出结果到控制台
    },
    timeout: 3000, //超时时间
    error: function(data) {
        console.log('请求失败'); //失败处理
    }
});

NodeJs

/**
 * API请求DEMO-NodeJs
 * 
 * 本demo支持GET与POST请求。
 */

const https = require('https');
const querystring = require('querystring');

// 定义请求选项
const options = {
  hostname: 'api.mznzd.com',
  path: '/api/compresspdf',
  method: 'POST'
};

// 发送POST请求
const postData = querystring.stringify({
  'token': 'YOUR_TOKEN',
  'file': '参数值',
  'optimizeLevel': '参数值',
  'expectedOutputSize': '参数值',
  'linearize': '参数值',
  'normalize': '参数值',
  'grayscale': '参数值',
  'lineArt': '参数值',
  'lineArtThreshold': '参数值',
  'lineArtEdgeLevel': '参数值',
});

const postOptions = {
  hostname: 'api.mznzd.com',
  path: '/api/compresspdf',
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
    'Content-Length': Buffer.byteLength(postData)
  }
};

const postReq = https.request(postOptions, res => {
  console.log(`statusCode: ${res.statusCode}`);

  res.on('data', d => {
    process.stdout.write(d);
  });
});

postReq.on('error', error => {
  console.error(error);
});

postReq.write(postData);
postReq.end();

Python

import requests

url = "https://api.mznzd.com/api/compresspdf"
data = {
    "token": "YOUR_TOKEN",
    "file": "参数值",
    "optimizeLevel": "参数值",
    "expectedOutputSize": "参数值",
    "linearize": "参数值",
    "normalize": "参数值",
    "grayscale": "参数值",
    "lineArt": "参数值",
    "lineArtThreshold": "参数值",
    "lineArtEdgeLevel": "参数值",
}

response = requests.post(url, data=data)
print(response.json())

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    apiURL := "https://api.mznzd.com/api/compresspdf"
    
    // POST请求
    data := url.Values{}
    data.Set("token", "YOUR_TOKEN")
    data.Set("file", "参数值")
    data.Set("optimizeLevel", "参数值")
    data.Set("expectedOutputSize", "参数值")
    data.Set("linearize", "参数值")
    data.Set("normalize", "参数值")
    data.Set("grayscale", "参数值")
    data.Set("lineArt", "参数值")
    data.Set("lineArtThreshold", "参数值")
    data.Set("lineArtEdgeLevel", "参数值")
    
    resp, err := http.Post(apiURL, "application/x-www-form-urlencoded", strings.NewReader(data.Encode()))
    if err != nil {
        fmt.Println("请求失败:", err)
        return
    }
    defer resp.Body.Close()
    
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Java

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;

public class ApiRequest {
    public static void main(String[] args) {
        try {
            String apiUrl = "https://api.mznzd.com/api/compresspdf";
            
            URL url = new URL(apiUrl);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setDoOutput(true);
            
            // 构建POST参数
            StringBuilder postData = new StringBuilder();
            postData.append("token=").append(URLEncoder.encode("YOUR_TOKEN", "UTF-8"));
            postData.append("&");            postData.append("file=").append(URLEncoder.encode("参数值", "UTF-8"));
            postData.append("&");            postData.append("optimizeLevel=").append(URLEncoder.encode("参数值", "UTF-8"));
            postData.append("&");            postData.append("expectedOutputSize=").append(URLEncoder.encode("参数值", "UTF-8"));
            postData.append("&");            postData.append("linearize=").append(URLEncoder.encode("参数值", "UTF-8"));
            postData.append("&");            postData.append("normalize=").append(URLEncoder.encode("参数值", "UTF-8"));
            postData.append("&");            postData.append("grayscale=").append(URLEncoder.encode("参数值", "UTF-8"));
            postData.append("&");            postData.append("lineArt=").append(URLEncoder.encode("参数值", "UTF-8"));
            postData.append("&");            postData.append("lineArtThreshold=").append(URLEncoder.encode("参数值", "UTF-8"));
            postData.append("&");            postData.append("lineArtEdgeLevel=").append(URLEncoder.encode("参数值", "UTF-8"));
            
            byte[] postDataBytes = postData.toString().getBytes("UTF-8");
            conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            conn.setRequestProperty("Content-Length", String.valueOf(postDataBytes.length));
            
            try (OutputStream os = conn.getOutputStream()) {
                os.write(postDataBytes);
            }
            
            BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            String line;
            StringBuilder response = new StringBuilder();
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
            reader.close();
            
            System.out.println(response.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        string apiUrl = "https://api.mznzd.com/api/compresspdf";
        
        using (HttpClient client = new HttpClient()) {
            // POST请求
            var formData = new Dictionary<string, string> {
                { "token", "YOUR_TOKEN" },
                { "file", "参数值" },
                { "optimizeLevel", "参数值" },
                { "expectedOutputSize", "参数值" },
                { "linearize", "参数值" },
                { "normalize", "参数值" },
                { "grayscale", "参数值" },
                { "lineArt", "参数值" },
                { "lineArtThreshold", "参数值" },
                { "lineArtEdgeLevel", "参数值" },
            };
            
            var content = new FormUrlEncodedContent(formData);
            HttpResponseMessage response = await client.PostAsync(apiUrl, content);
            
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

/**
 * API请求DEMO-C
 * 
 * 本demo支持GET与POST请求。
 * 需要安装libcurl库
 */

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <curl/curl.h>

// API地址
const char* url = "https://api.mznzd.com/api/compresspdf";

// POST请求
void postRequest(CURL* curl) {
    CURLcode res;
    const char* postData = "token=YOUR_TOKEN&file=%E5%8F%82%E6%95%B0%E5%80%BC&optimizeLevel=%E5%8F%82%E6%95%B0%E5%80%BC&expectedOutputSize=%E5%8F%82%E6%95%B0%E5%80%BC&linearize=%E5%8F%82%E6%95%B0%E5%80%BC&normalize=%E5%8F%82%E6%95%B0%E5%80%BC&grayscale=%E5%8F%82%E6%95%B0%E5%80%BC&lineArt=%E5%8F%82%E6%95%B0%E5%80%BC&lineArtThreshold=%E5%8F%82%E6%95%B0%E5%80%BC&lineArtEdgeLevel=%E5%8F%82%E6%95%B0%E5%80%BC";
    
    curl_easy_setopt(curl, CURLOPT_URL, url);
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData);
    res = curl_easy_perform(curl);
    
    if(res != CURLE_OK) {
        fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
    }
}

int main() {
    CURL* curl = curl_easy_init();
    if(curl) {
        postRequest(curl);        curl_easy_cleanup(curl);
    }
    return 0;
}

C++

/**
 * API请求DEMO-C++
 * 
 * 本demo支持GET与POST请求。
 * 需要安装libcurl库
 */

#include <iostream>
#include <string>
#include <curl/curl.h>

int main() {
    CURL* curl = curl_easy_init();
    if(curl) {
        std::string apiUrl = "https://api.mznzd.com/api/compresspdf";
        
        // POST请求
        std::string postData = "token=YOUR_TOKEN&file=%E5%8F%82%E6%95%B0%E5%80%BC&optimizeLevel=%E5%8F%82%E6%95%B0%E5%80%BC&expectedOutputSize=%E5%8F%82%E6%95%B0%E5%80%BC&linearize=%E5%8F%82%E6%95%B0%E5%80%BC&normalize=%E5%8F%82%E6%95%B0%E5%80%BC&grayscale=%E5%8F%82%E6%95%B0%E5%80%BC&lineArt=%E5%8F%82%E6%95%B0%E5%80%BC&lineArtThreshold=%E5%8F%82%E6%95%B0%E5%80%BC&lineArtEdgeLevel=%E5%8F%82%E6%95%B0%E5%80%BC";
        curl_easy_setopt(curl, CURLOPT_URL, apiUrl.c_str());
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str());
        
        CURLcode res = curl_easy_perform(curl);
        
        if(res != CURLE_OK) {
            std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;
        }
        
        curl_easy_cleanup(curl);
    }
    return 0;
}

易语言

.版本 2

.支持库 spec

.子程序 _启动子程序
.局部变量 url, 文本型
.局部变量 data, 文本型
.局部变量 result, 文本型

url ＝ "https://api.mznzd.com/api/compresspdf"
data ＝ "token=YOUR_TOKEN&file=%E5%8F%82%E6%95%B0%E5%80%BC&optimizeLevel=%E5%8F%82%E6%95%B0%E5%80%BC&expectedOutputSize=%E5%8F%82%E6%95%B0%E5%80%BC&linearize=%E5%8F%82%E6%95%B0%E5%80%BC&normalize=%E5%8F%82%E6%95%B0%E5%80%BC&grayscale=%E5%8F%82%E6%95%B0%E5%80%BC&lineArt=%E5%8F%82%E6%95%B0%E5%80%BC&lineArtThreshold=%E5%8F%82%E6%95%B0%E5%80%BC&lineArtEdgeLevel=%E5%8F%82%E6%95%B0%E5%80%BC"
result ＝ 网页_访问 (url, 1, data, , , , , , , , , )

调试输出 (result)

常见问题

查找常见问题的解决方案

暂无常见问题

该接口暂未添加常见问题说明