autumn-create-customer

Autumn の顧客設定

コード例と最新の API については、必ず docs.useautumn.com を参照してください。

---

クイックリファレンス

環境変数

• AUTUMN_SECRET_KEY - 必須。app.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 Router	app/api/autumn/[...all]/route.ts	autumn-js/next
React Router	app/routes/api.autumn.tsx	autumn-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. 冪等性 - customers.create は、ID がすでに存在する場合、既存の顧客を返します。
3. バックエンド URL - API が別のドメインにある場合は、プロバイダーに backendUrl を渡してください。
4. シークレットキー - AUTUMN_SECRET_KEY はサーバーサイドでのみ保持してください。

---

リソース

• セットアップドキュメント
• React のセットアップ
• LLMs.txt