API Console

这个页面可以直接在文档里运行 POST /api/v1/render 请求。

选择内置示例，或粘贴你自己的 JSON
填写 endpoint 和 Bearer token
在同一页查看 PDF、错误 JSON 和响应头

API Console

像 Postman 一样直接调试 gPdf API。左侧编辑请求，右侧查看 PDF、错误 JSON 和响应头。

支持直接查看 PDF、错误 JSON 和响应头。

示例

10 秒上手最小请求，用来确认 token、endpoint 和 PDF 返回链路。
推荐的第一份生产样例包含页眉、页脚、图片资源、条码和常见文本字段。
图片资源简写对象存储图片的顶层 asset + format 写法。
图片显式 Base64 写法内联图片的 source.kind = base64 写法。
Block text推荐的完整文本 contract，使用 frame/defaults/content.blocks。

Endpoint

Bearer Token

直接请求接口时需要 Bearer token。

Request ID

可选。不填时系统会自动生成。

Request Body默认使用 POST 和 application/json。

{
  "settings": {
    "defaults": {
      "text": {
        "font_family": "NotoSans-Regular",
        "font_size": 10.5,
        "color": "#111827"
      },
      "stroke": {
        "color": "#111827",
        "width": 0.3
      }
    },
    "output": {
      "mode": "file",
      "file_name": "shipping-label.pdf"
    }
  },
  "header": {
    "height": 10,
    "elements": [
      {
        "type": "text",
        "x": 8,
        "y": 6,
        "content": "PDN EXPRESS"
      }
    ]
  },
  "footer": {
    "height": 8,
    "elements": [
      {
        "type": "text",
        "x": 8,
        "y": 4,
        "content": "Page ",
        "style": {
          "width": 30
        }
      }
    ]
  },
  "pages": [
    {
      "size": "label_100_150",
      "elements": [
        {
          "type": "image",
          "x": 8,
          "y": 12,
          "width": 18,
          "height": 8,
          "asset": "pdn_express_logo",
          "format": "jpg"
        },
        {
          "type": "text",
          "x": 8,
          "y": 26,
          "content": "Order #SO-20260415-001",
          "style": {
            "font_size": 11,
            "font_weight": "bold"
          }
        },
        {
          "type": "barcode",
          "x": 8,
          "y": 34,
          "width": 58,
          "height": 18,
          "format": "code128",
          "content": "SO-20260415-001",
          "barcode_text": {
            "enabled": true
          }
        },
        {
          "type": "rect",
          "x": 8,
          "y": 56,
          "width": 84,
          "height": 28,
          "stroke": {
            "color": "#D1D5DB",
            "width": 0.3
          }
        },
        {
          "type": "text",
          "x": 12,
          "y": 62,
          "content": "Recipient: Alex Chen"
        },
        {
          "type": "text",
          "x": 12,
          "y": 70,
          "content": "Address: 88 Harbor Road, Shanghai"
        }
      ]
    }
  ]
}

Response

运行成功后，PDF 会显示在这里。

API Console ​

API Console

Response

API Console