用途：搭建 Klaviyo 官方 Node.js SDK 环境并配置私有 API 密钥认证，对接 Klaviyo REST API（revision 2024-10-15）。
主要能力：安装官方 klaviyo-api 包（注意不是已废弃的 @klaviyo/sdk）；区分私有密钥（pk_ 前缀，服务端 REST API，请求头 Authorization: Klaviyo-API-Key pk_***）与公开密钥（6 位，仅客户端 Track/Identify，查询参数 company_id）；初始化 ApiKeySession 并导出 ProfilesApi、EventsApi、ListsApi 等按资源划分的客户端；通过 AccountsApi.getAccounts() 验证密钥；处理 401、403、429、MODULE_NOT_FOUND、ENOTFOUND 等错误。
使用方式：前置条件为 Node.js 18+（Python 可用 3.10+ 与 Python SDK）、Klaviyo 账号及后台 Settings > API Keys 生成的私有密钥。安装命令：npm install klaviyo-api。将私有密钥存入 .env 并确保被 gitignore。初始化示例：import { ApiKeySession, ProfilesApi, EventsApi, ListsApi } from 'klaviyo-api'; const session = new ApiKeySession(process.env.KLAVIYO_PRIVATE_KEY!); 再分别 new ProfilesApi(session) 等。SDK 会自动添加 revision 头，裸 HTTP 请求需手动加 revision: 2024-10-15。可用 cURL 快速验证：curl -X GET "https://a.klaviyo.com/api/profiles/" -H "Authorization: Klaviyo-API-Key pk_***" -H "revision: 2024-10-15" -H "Accept: application/vnd.api+json"，返回 200 表示密钥与版本头有效，401 为密钥错误，403 为缺少 profiles:read 等作用域。
适用场景：新建 Klaviyo 集成、配置 API 密钥、初始化 SDK 客户端。
限制：速率限制为突发 75 req/s、稳定 700 req/min，需遵循 Retry-After 头；公开密钥不得用于服务端代码；具体作用域表、Python 配置与完整示例见资料中的 references 文件，本处未展开。