mcpField
A
autumn-create-customer

autumn-create-customer

github.com/useautumn开发150 次安装3 周前更新
代码仓库

关于 autumn-create-customer

用于在 React 与 Node.js 应用或纯后端服务中接入 Autumn 客户管理的技能，涵盖处理器与 Provider 设置、创建客户及关键集成决策。

主要功能

  1. 01React 与 Node.js 集成路径
  2. 02纯后端创建客户
  3. 03支持 Next.js、Hono、Express 和 Fastify 处理器
  4. 04React 客户 Provider 与 Hook
  5. 05B2C 和 B2B 客户 ID 指引

适用场景

  1. 01为 React 应用接入 Autumn 客户管理
  2. 02从后端服务创建客户
  3. 03选择用户或组织客户 ID

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/useautumn/skills --skill autumn-create-customer

安装后在 Claude Code 中输入/autumn-create-customer确认已加载。

详细介绍

Autumn 客户设置

代码示例和最新 API 请始终参阅 docs.useautumn.com。

快速参考

环境变量
安装
npm install autumn-js    # Node.js
pip install autumn-py    # Python

集成路径

技术栈路径
React + Node.js挂载处理程序 + AutumnProvider
仅后端初始化客户端 + 调用 API

路径 A：React + Node.js

处理程序设置
框架文件导入
Next.js App Routerapp/api/autumn/[...all]/route.tsautumn-js/next
React Routerapp/routes/api.autumn.tsxautumn-js/react-router
Hono任意文件autumn-js/hono
Express任意文件autumn-js/express
Fastify任意文件autumn-js/fastify
import { autumnHandler } from "autumn-js/next";

export const { GET, POST } = autumnHandler({
  identify: async (request) => {
    const session = await getSession(request);
    return {
      customerId: session.user.id,  // or session.org.id for B2B
      customerData: { name: session.user.name, email: session.user.email },
    };
  },
});
客户端设置
import { AutumnProvider } from "autumn-js/react";

<AutumnProvider>{children}</AutumnProvider>

// Different backend URL:
<AutumnProvider backendUrl={process.env.NEXT_PUBLIC_API_URL} />
验证
import { useCustomer } from "autumn-js/react";

const { customer } = useCustomer();
console.log("Autumn customer:", customer);

路径 B：仅后端

初始化
import { Autumn } from "autumn-js";

const autumn = new Autumn({ secretKey: process.env.AUTUMN_SECRET_KEY });

from autumn import Autumn

autumn = Autumn('am_sk_test_xxx')
创建客户
const { data } = await autumn.customers.create({
  id: "user_id_from_auth",
  name: "Test User",
  email: "[email protected]",
});

常见注意事项

  1. B2C 与 B2B - 集成前请决定 customerId 是用户 ID 还是组织 ID
  2. 幂等性 - 如果 ID 已存在，customers.create 会返回现有客户
  3. 后端 URL - 如果 API 位于其他域名，请向提供程序传递 backendUrl
  4. 密钥 - 仅在服务端保留 AUTUMN_SECRET_KEY

资源

评论

支持 Markdown