qgproxy-sdk

青果代理内部中转服务的 Node.js SDK，同时支持 ESM 与 CommonJS，要求 Node.js 18 或更高版本。

npm install qgproxy-sdk

ESM

import { QgProxyClient } from "qgproxy-sdk";

const client = new QgProxyClient({
  token: process.env.QGPROXY_TOKEN!,
  baseUrl: process.env.QGPROXY_BASE_URL!
});

const result = await client.acquire({
  count: 10,
  area: ["440100"],
  isp: 1,
  distinct: true
});

CommonJS

const { QgProxyClient } = require("qgproxy-sdk");

const client = new QgProxyClient({
  token: process.env.QGPROXY_TOKEN,
  baseUrl: process.env.QGPROXY_BASE_URL
});

构造参数：

• token：业务专属 Token，必填；
• baseUrl：代理服务地址，必填，不提供默认值；
• timeoutMs：客户端总请求超时，默认 15000ms。

acquire() 的 waitTimeoutMs 控制服务端等待青果调用许可和响应的时间；客户端 timeoutMs 应设置得略大于它。

Token 由 qgproxy 管理员按业务分别创建，不要写入源码或提交到 Git。