跳到主要内容

YuzucaPrivateClient(服务端 API 客户端)

import { YuzucaPrivateClient } from "@yuzuca/sdk";

const client = new YuzucaPrivateClient({
apiKey: process.env.YUZUCA_PRIVATE_KEY!,
serverUrl: "https://your-server.example.com",
});

常用能力:

  • client.info.get()
  • client.entitlements.check(...)
  • client.usage.deduct(...)
  • client.customers.create(...)
  • client.customers.resolve(identifier)
  • client.customers.get(customerId)
  • client.subscriptions.activate(...)
  • client.codes.redeem(...)
const customer = await client.customers.create({
username: "customer_001",
password: "secret",
identifiers: [
{ type: "email", value: "user@example.com" },
{ type: "external_user_id", value: "u_1001" },
],
});

const resolved = await client.customers.resolve({
type: "external_user_id",
value: "u_1001",
});

const entitlement = await client.entitlements.checkOne({
customer: { type: "external_user_id", value: "u_1001" },
feature: "image-generate",
required: 1,
});

await client.usage.deduct({
customer: { type: "email", value: "user@example.com" },
feature: "image-generate",
amount: 1,
});