简介
butterscotch 是一个基于 JavaScript/TypeScript 的 API 客户端 SDK，可以用于与 ButterCMS、ButterEmail 和 ButterVideo 三个 API 的交互。butter-provider-tvapi 是其中的一个 npm 包，可以用于与 ButterVideo 的 API 进行交互。
安装
在开始使用之前，需要先安装这个 npm 包。可以使用 npm 进行安装：
npm install butter-provider-tvapi
基础使用
在安装完成后，就可以使用这个 npm 包了。首先，需要先引入这个包：
const Butter = require('butter-provider-tvapi').default;然后，可以通过 Butter 类初始化一个 ButterVideo 的 API 客户端。
const butter = Butter('API_KEY');其中 API_KEY 参数是 ButterVideo 中的 API 鉴权密钥。
现在，就可以使用 butter 客户端对象进行 API 调用了。比如，可以通过 getVideo 方法来获取一个视频的详细信息：
butter.getVideo('VIDEO_SLUG').then(response => {
console.log(response.data);
}).catch(error => {
console.error(error);
});其中 VIDEO_SLUG 参数是视频的唯一标识符。
高级使用
butter-provider-tvapi 包支持比较多的配置选项，可以进行更细粒度的控制。
选项说明
以下列出了这个包支持的主要选项。
| 名称 | 类型 | 描述 |
|---|---|---|
baseURL |
string | API 的基础 URL |
timeout |
number | API 调用超时时间（毫秒） |
headers |
object | HTTP 请求的头部信息 |
params |
object | URL 查询参数 |
auth |
object | API 鉴权信息 |
proxy |
object | HTTP 代理信息 |
maxContentLength |
number | 响应数据的最大长度（字节） |
maxRedirects |
number | 最大重定向次数 |
withCredentials |
boolean | 是否在跨域请求中发送凭据 |
使用示例
以下是一个带有自定义配置的示例：
-- -------------------- ---- -------
----- ----- - -----------------
----- ------ - -----------------------------------------
----- ------ - --------
-------- -------------------------------
-------- -----
-------- -
------------------- ----------
--
------- -
----------- ---
--
----- -
--------- -----------
--------- -----------
--
------ -
----- -------------
----- -----------
--
----------------- ------
------------- --
---------------- -----
-- -------在这个示例中，我们传入了一个自定义的配置对象，其中：
baseURL设置为 ButterCMS 的 API 基础 URL；timeout设置为 5000 毫秒，即 5 秒；headers包含了一个 HTTP 请求头部字段，用于 API 鉴权；params包含了一个 URL 查询参数；auth包含了一个用户名和密码，用于 Basic 认证；proxy指定了一个 HTTP 代理；maxContentLength设为 50000 字节，即 50KB；maxRedirects设为 5 次；withCredentials设为 true，支持跨域请求时携带凭据。
结语
以上就是 butter-provider-tvapi npm 包的使用说明。通过这个包，我们可以方便地访问 ButterVideo 的 API，获取各种视频相关的信息。希望这篇文章对前端开发工程师有所帮助！
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066c8eccdc64669dde55e7