快速开始

本页目录

1. 登记应用 2. 接统一登录 3. 按需开通其他能力 4. 对照样例

接入灵策中台分三步：登记应用、接登录、按需开通其他能力。登录是其他能力的基础，收款、通知要用到登录拿到的用户 id。

#1. 登记应用

目前没有自助注册。把应用 ID、名称、首页和回调地址发给灵策运营，由运营在后台登记。登记后你的 client_id 就是应用 ID。

#2. 接统一登录

登录走 OIDC 授权码流程，安全靠 PKCE（S256），不需要 client secret。先确认 discovery 能取到：

Shell

curl -s https://center.lynxce.cn/.well-known/openid-configuration

TypeScript 项目用 SDK，一步拿到授权地址，回调里一步换令牌并校验 id_token：

TypeScript

import { CenterClient } from "@ai-employee/center-sdk";

const center = new CenterClient({
  issuer: "https://center.lynxce.cn",
  clientId: "your-app",
  redirectUri: "https://your-app.example.com/auth/lynxce/callback",
  scope: "openid profile",
});

// 发起登录：把 state、nonce、codeVerifier 存进服务端会话，再跳转
const login = await center.createLoginRequest();

// 回调：从会话取回上面存的值（pending），校验 state，换令牌，验 id_token
const { claims } = await center.handleCallback({
  callback: new URL(req.originalUrl, "https://your-app.example.com"),
  expectedState: pending.state,
  codeVerifier: pending.codeVerifier,
  nonce: pending.nonce,
});

// claims.sub 是灵策用户 id，用它绑定你的本地账号

其他语言按统一登录的端点和校验要求直接调 HTTP 接口。

#3. 按需开通其他能力

每项能力默认关闭，找灵策运营开通。不同能力用不同凭证，所有凭证只能放在服务端：

能力	凭证	文档
登录	`client_id`，无密钥	统一登录
收款	`client_id` + `client_secret`（`lcs_…`），Webhook 验签用 `whsec_…`	收款与 Webhook
通知、文件	`client_id` + `client_secret`	通知与文件
模型	应用 API Key（`sk-…`）	模型调用

client_secret、whsec_… 和 sk-… 都只显示一次，丢失后只能轮换。服务端调用示例：

TypeScript

import { CenterServerClient } from "@ai-employee/center-sdk";

const server = new CenterServerClient({
  baseUrl: "https://center.lynxce.cn",
  clientId: process.env.LYNXCE_CLIENT_ID!,
  clientSecret: process.env.LYNXCE_CLIENT_SECRET!,
});

await server.sendNotification({
  userId: claims.sub,
  title: "订单已发货",
  body: "你的订单已发货。",
  eventKey: "order-shipped:A-1001",
});

模型调用不用这个客户端，直接用 OpenAI 官方 SDK，baseURL 设为 https://center.lynxce.cn/api/v1。

#4. 对照样例

接口报错时查错误码参考，里面写了每个码该怎么处理。

接入样例把登录、收款、Webhook、通知、文件串成一个完整的小产品，遇到细节问题可以对照它的写法。