:: 账单文档 API ::

JSONBill

轻量级 JSON 账单文档生成

为开发者和 AI 代理设计

通过简单的 RESTful API 从 JSON 数据创建专业的 PDF 发票与结算单。支持积分或 x402（Base 上 USDC）支付。

开始使用 G 阅读文档 D 主题示例 T

出品： Quaily

:: 实时数据 ::
—
已生成 PDF 文档
GET /stats
>_

快速

超轻量 API，几乎零额外开销。文档可在毫秒级生成。

{}

简单

JSON 输入、PDF 输出，无需复杂 SDK 或配置，任何语言都可用。

[#]

AI 就绪

为 AI 代理设计，适合自动化计费流程和代理式应用。

curl -X POST https://api.jsonbill.com/tasks/docs \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <APIKey>" \
  -d @doc.json
curl -X POST https://api.jsonbill.com/tasks/docs \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64 signature>" \
  -d @doc.json
[*]

特性

专业文档生成所需的一切

{}

> JSON 格式

使用 JSON 格式处理账单数据

.pdf

> PDF 输出

生成专业的 PDF 发票与结算单

$$$

> 多币种

支持多种货币和税率

BTC

> 加密货币支付

支持 x402（Base 上 USDC）链上支付，并内置加密货币收款字段

[#]

> 主题模板

多种内置发票/结算单模板

[~]

> 安全

支持 JWT 与 API key 认证，保障访问安全

[SK]

面向代理的 SKILL.md

提供可直接使用的 SKILL 文件，帮助 AI 代理正确调用 JSONBill。

可加入你的 agent skills，或按需用 curl 获取。

$ curl -s https://jsonbill.com/SKILL.md
打开 SKILL.md
[?]

常见问题

$
JSONBill 是一个轻量级 API，可以从 JSON 数据生成专业的 PDF 发票与结算单，面向开发者和 AI 代理，使用简单。
$
你可以用 Authorization（JWT/API key）按 credits 计费，或用 x402（Base 上 USDC）按次付费（无需 Authorization）。x402 流程通常是先收到 402（PAYMENT-REQUIRED），再携带 PAYMENT-SIGNATURE 重试。
$
params.currency 是默认货币；可用 summary.currency 与 detail_items[].currency 覆盖局部货币。若要展示参考货币等值金额（隐含汇率），使用 total_include_tax_quote_amount 与 total_include_tax_quote_symbol（summary 与 detail_items[] 都支持）。
$
生成的 PDF 文档在创建后 1 小时内可供下载，之后会自动删除。
$
发票使用 bill_to_company/bill_to_address。结算单使用 recipient_company/recipient_address，并设置 type=settlementstatement。结算单会忽略 payment.instruction，只渲染 payment.result。
$
total_include_tax 与 total_exclude_tax 二选一。若使用 total_exclude_tax，请同时提供 tax 或 tax_rate，以便在 PDF 中展示税额/含税总额。
──────────────────── [ START ] ────────────────────

准备开始生成文档？

几分钟即可用上我们的简洁 API

开始使用 G 阅读文档 D