跳到主要内容
api工厂
首页 / 后台管理 / 后台 SDK

后台 SDK apifm-admin

后台里的每个数据、每个按钮,都有对应的开放接口。用后台 SDK 自己开发后台,或把管理功能直接集成进你现有的系统(比如 ERP),支持 Web、uni-app、微信小程序。

自己开发全功能后台

不使用我们的后台界面,用后台 SDK 与你自己的技术栈搭建专属管理系统。

集成到现有系统

把商品、订单、用户等管理能力嵌入 ERP、OA 等已有系统,业务数据统一管理。

AI 自动开发

配置 后台开发 MCP,AI 自动检索后台 SDK 方法并生成界面。

安装

API 工厂后台接口 SDK,支持 Web、uni-app、微信小程序。

bash
npm install apifm-admin

快速开始

登录后台后获得 xtoken,之后调用其他后台方法时 SDK 会自动携带。

javascript
import apifmAdmin from 'apifm-admin'

apifmAdmin.setConfig({
  token: '后台登录后的 xtoken'
})

const res = await apifmAdmin.loginAdminMobile({
  mobile: '13800138000',
  pwd: '123456',
  rememberMe: true
})

动态获取 X-Token

如果每个项目保存 token 的位置不同,不需要重写请求适配器,只注入获取 token 的方法即可:

javascript
import apifmAdmin from 'apifm-admin'

apifmAdmin.setTokenGetter(() => {
  return uni.getStorageSync('tokenData')?.token || ''
})

也可以通过 setConfig 一起配置:

javascript
apifmAdmin.setConfig({
  tokenGetter: () => uni.getStorageSync('tokenData')?.token || ''
})

SDK 会在每次请求前调用 tokenGetter,并自动写入唯一的 X-Token 请求头。

跨端请求适配

默认按顺序优先使用:uni.request → wx.request → fetch。只有在需要完全接管请求行为时,才需要手动注入请求适配器:

javascript
import apifmAdmin from 'apifm-admin'

apifmAdmin.setRequestAdapter(async (requestOptions) => {
  const { url, method, data, headers } = requestOptions
  const response = await fetch(url, {
    method,
    headers: {
      'Content-Type': 'application/x-www-form-urlencoded',
      ...headers
    },
    body: method === 'GET' ? undefined : new URLSearchParams(data).toString()
  })
  return response.json()
})

全局配置

javascript
apifmAdmin.setConfig({
  token: 'xtoken',
  headers: {
    'X-Token': 'xtoken'
  }
})

支持动态修改:

javascript
apifmAdmin.setToken('xtoken')
apifmAdmin.setTokenGetter(() => uni.getStorageSync('tokenData')?.token || '')
apifmAdmin.setHeader('tenant-id', '1001')
apifmAdmin.setDomain('common', 'https://common.apifm.com')

安全建议

后台 token 拥有管理权限。请只在受信任的后台页面或服务端使用,不要把 xtoken 写进公开的前端代码、代码仓库或日志,也不要发给 AI 对话。