快速开始
签发 user_token
给产品侧 client 一个可以调用 City 的用户凭证。
user_token 需要由可信环境签发。开发者后端使用 Admin City，基于 city_id + user_id 向 City 申请 token。
import { City } from "@downcity/city";
const admin = new City({
role: "admin",
federation_url: "https://base.example.com",
city_id: "city_demo",
admin_secret_key: process.env.DOWNCITY_FEDERATION_ADMIN_SECRET_KEY,
});
const user = await admin.tokens.apply({
user_id: "user_123",
metadata: {
plan: "pro",
},
ttl: "7d",
});把 user.user_token 和 user.city_id 返回给产品 client。
metadata 的作用
metadata 可以把套餐、组织 ID 等业务信息带进 hook。
const action = service.action("generate", async (ctx) => {
return generateSomething(ctx.input);
});
action.before(async (ctx) => {
await quotaService.check({
city_id: ctx.city?.city_id,
user_id: ctx.user?.user_id,
plan: ctx.user?.metadata?.plan,
});
});这样多个 client 可以共享一套鉴权和限额判断。