# @abacatepay/rest 中文文档

规范地址：https://npmcn.com/package/%40abacatepay/rest/

版本：1\.1\.0
npm 元数据更新时间：2026-10-12T15:29:36.028Z
中文译文更新时间：2026-11-06T04:22:49.611Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40abacatepay/rest
原文对照：https://npmcn.com/package/%40abacatepay/rest/?lang=original
项目主页：https://github.com/AbacatePay/ecosystem#readme
源码仓库：https://github.com/AbacatePay/ecosystem

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：18.3 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-01-15T11:41:23.254Z
- 最新版本发布：2026-10-12T15:29:35.841Z
- 近 30 天下载量：5197（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

AbacatePay API 的 REST 客户端

## 安装

```sh
npm install @abacatepay/rest
```

也可以使用：`pnpm add @abacatepay/rest`、`yarn add @abacatepay/rest`、`bun add @abacatepay/rest`

## README

# 免费付费

Um REST客户端 para a API da AbacatePay – rápido, seguro e testado. 中国植物物种信息数据库.  
欧 [`@abacatepay/rest`](https://www.npmjs.com/package/@abacatepay/rest) 额.. **客户端e REST leve e totalmente tipado** a API do AbacatePay. 请检查date=中的日期值 (帮助) API do AbacatePay.  
普罗耶塔多段落 **节点js, Bun e runtimes 现代**停止 停止 停止.

![AbacatePay Open Source](https://res.cloudinary.com/dkok1obj5/image/upload/v1767631413/avo_clhmaf.png)

## 英斯特拉桑

使用 com o sue _软件包管理器_ 偏爱托

```bash
bun add @abacatepay/rest
# Ou
pnpm add @abacatepay/rest
# Ou
npm install @abacatepay/rest
```

## 乌索·巴西克

Simule um pagamento 克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 `pix_char_123456`

```ts
import { createREST } from '@abacatepay/rest';

const client = createREST({
    secret: process.env.ABACATEPAY_API_KEY!,
});

const pix = await client.post('/transparents/simulate-payment', {
    query: { id: 'pix_char_123456' },
});

console.log(pix);
```

## 重试后退( B)

Por paderão, o REST FAZ até (法语) **3次重试** 自动调解:

-   请求 `GET` 电子 `HEAD` são repetidas em超时 e 第408, 第425, 第429 e 5xx.
-   欧斯出道者`POST`, (中文(简体) ), `PUT`, (中文(简体) ), `PATCH`, (中文(简体) ), `DELETE`(中文(简体) ) **第429页**,将 API 对应 actes de executor a requisição 。 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}再做一次 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}再做一次 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}嗯...

```ts
const client = createREST({
    retry: {
        max: 5
    },
})
```

## 超时

暂停执行 **30 segundos (30 segundos) (30 segundo) (30 segundo) (30 segundo) (30 segundo) (30 segundo) (30 sgundo) (30 s** (原始内容存档于2012-10-12) (英语). cole ser terado no cliente ou uma requisição específica. 泉道 嗯 泉道 `POST` (原始内容存档于2018-09-21) (英语). dát-timeout, o rocho avisa que ele pode ter sido processado: conferue o recentso antes de tentar de novo.

```ts
const client = createREST({ timeout: 60_000 });

const { success, error } = await client.post('/pix/send', {
    body,
    timeout: 90_000,
});
```

### 备份自定义

```ts
const client = createREST({
    retry: {
        max: 7,
        backoff(attempt) {
            // Backoff exponencial
            return Math.min(10_000, 500 * 2 ** attempt);
        },
    },
});
```

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}是的 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}是的 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}是的.

## 特拉坦多错

OREST 客户端 **尼尼卡·兰萨** - toda chamada 解决 com o mesmo格式 `{ data, error, success }` (原始内容存档于2018-09-26). que a própria API da AbacatePay redrona. Falhas do lado do cliente (rede, timeout, secret ausente) são normalizadas para sesse mesmo formato. 互联网档案馆的存檔,存档日期2014-12-21., p.

```ts
const { data, error, success } = await client.get('/customers/invalid');

if (!success) {
    console.error('Erro:', error);

    return;
}

console.log(data);
```

Você pode ver a documentação completa por 页面存档备份,存于互联网档案馆 [亚基](https://docs.abacatepay.com/pages/rest)。 。 。 .

飞来飞去,飞来飞去  
开源,德·维尔达德.

## 常见问题

### @abacatepay/rest 是什么？

AbacatePay API 的 REST 客户端

### 如何安装 @abacatepay/rest？

在项目目录运行 npm install @abacatepay/rest，或使用 pnpm add / yarn add / bun add。

### @abacatepay/rest 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @abacatepay/rest 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @abacatepay/rest 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @abacatepay/rest 可以商用吗？

@abacatepay/rest 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @abacatepay/rest 的下载量有多少？

根据 npm 官方下载统计，@abacatepay/rest 在 2026/10/05 – 2026/11/03 这 30 天内被下载 5,197 次，日均约 173 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @abacatepay/rest 还在维护吗？

最新版本 1\.1\.0 发布于 2026/10/12（24 天前）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/01/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。