只需前端技能,无需购买服务器,通过 SDK 与中台数据交互,即可独立开发微信小程序、H5、App、鸿蒙应用等全端产品。
6 种平台的安装与使用教程,当前 npm 最新版本 v26.11.20。左侧菜单可浏览全部 SDK 方法。
查看使用说明 →左边写代码,右边手机实时预览。搜索 SDK 方法,一键生成可运行的代码,控制台实时报错。
打开在线调试 →选择你的开发平台,直接查看具体用法。
下面所有示例中的 你的subDomain 和 你的商户ID,都在后台里查看,复制过来替换即可。
提示:专属域名默认是 32 位长度,你可以自己修改成一个比较短、好记的域名再使用。修改后,代码里也要同步替换。
小程序项目根目录需存在 package.json,没有的话先执行下面的命令,确认生成后再继续。
npm init一键安装 SDK 最新版本。
npm install apifm-wxapi在微信开发者工具中点击「工具 → 构建 npm」,提示构建成功后才能使用。
init() 与 setMerchantId() 在 app.js 中全局执行一次即可,之后就能调用任意 SDK 方法读写后台数据。
// app.js
const WXAPI = require('apifm-wxapi')
WXAPI.init('你的subDomain')
WXAPI.setMerchantId(你的商户ID)
// 任意页面
const res = await WXAPI.banners()
if (res.code == 0) {
this.setData({ banners: res.data })
}开源参考:wechat-app-mall(GitHub) · 码云镜像
一键安装 SDK 最新版本。
npm install apifm-webapi在 main.js 中设置专属域名与商户 ID,并挂载到 Vue 原型上。
import WEBAPI from 'apifm-webapi'
WEBAPI.init('你的subDomain')
WEBAPI.setMerchantId(你的商户ID)
Vue.prototype.$wxapi = WEBAPI在组件内通过 this.$wxapi 直接调用。
const res = await this.$wxapi.banners()
if (res.code == 0) {
this.banners = res.data
}在 js 文件中直接加载 SDK,因已全局初始化,无需再次 init。
const WXAPI = require('apifm-webapi')
const res = await WXAPI.banners()开源参考:vueMinishop(GitHub) · 码云镜像
npm 能力要求基础库不低于 2.12.0,开发者工具 3.1.1 及以上。
项目根目录需存在 package.json,没有的话先执行:
npm init安装后在开发者工具中执行构建,提示成功后才能使用。
npm install apifm-ttapiinit() 与 setMerchantId() 在 app.js 中全局执行一次即可。
const WXAPI = require('apifm-ttapi')
WXAPI.init('你的subDomain')
WXAPI.setMerchantId(你的商户ID)
const res = await WXAPI.banners()
if (res.code == 0) {
this.setData({ banners: res.data })
}在 pubspec.yaml 中加入依赖。
dependencies:
apifm: ^0.0.5运行命令拉取依赖。
flutter pub get导入后先设置专属域名和商户 ID,再调用任意 SDK 方法。
import 'package:apifm/apifm.dart' as WXAPI;
WXAPI.init('你的subDomain');
WXAPI.setMerchantId(你的商户ID);
final res = await WXAPI.banners();一键安装 SDK 最新版本。
npm install apifm-uniapp在 main.js 中设置专属域名与商户 ID 并挂载。
import WXAPI from 'apifm-uniapp'
WXAPI.init('你的subDomain')
WXAPI.setMerchantId(你的商户ID)
Vue.prototype.$wxapi = WXAPI直接通过 this.$wxapi 调用。
const res = await this.$wxapi.banners()
if (res.code == 0) {
this.banners = res.data
}已全局初始化,无需再次 init。
const WXAPI = require('apifm-uniapp')
const res = await WXAPI.banners()在页面中用 <script> 直接引入下面的完整地址,无需下载、无需打包。每个页面只引入一个,之后即可使用全局变量 APIFM。
<script src="https://www.apifm.com/apifm.min.js"></script>在调用任何接口之前执行一次:先设置专属域名(subDomain),再设置商户 ID。两者都在后台「工厂设置 → 商户信息」中查看,见上方说明。
APIFM.init('你的subDomain')所有方法以 APIFM.方法名(参数) 调用,返回 Promise,数据结构为 { code, data, msg },code == 0 表示成功。
// 写法一:then
APIFM.banners().then(res => {
if (res.code == 0) console.log(res.data)
else console.error(res.msg)
})
// 写法二:async / await
const res = await APIFM.banners()提示 APIFM is not defined 说明 script 路径不对或代码写在了引入之前;不要用 file:// 直接打开页面,建议用本地服务器;跨域报错请在后台确认域名访问设置。