apifm-admin

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

安装

npm install apifm-admin

快速开始

import apifmAdmin from 'apifm-admin'

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

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

动态获取 X-Token

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

import apifmAdmin from 'apifm-admin'

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

也可以通过 setConfig 一起配置：

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

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

跨端请求适配

默认优先使用：

1. uni.request
2. wx.request
3. fetch

只有在需要完全接管请求行为时，才需要手动注入请求适配器：

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()
})

全局配置

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

支持动态修改：

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

发布

npm publish

执行发布前会自动运行：

npm run build

该命令会重新扫描以下 Java 项目并生成最新 SDK：

• D:\java\apifmCommon
• D:\java\jd-vop
• D:\java\apifmCms
• D:\java\apifactory