加载中…

纯 HTML 使用教程(无需 npm / 无需打包)

# 纯 HTML 使用教程(无需 npm / 无需打包) 在任何 HTML 网页中,只需引入一个 js 文件,即可通过全局变量 `APIFM` 调用 SDK 的所有方法。 ## 1. 引入 js 你的网页,用 ` ``` 海外版: ```html ``` > 两个版本的用法完全一致,只是请求的地址不同。每个页面只引入其中一个。 > ## 2. 初始化 先在 [api工厂后台](https://www.apifm.com) 获得你的专属域名(subDomain),在调用任何接口之前执行一次: ```javascript APIFM.init('你的subDomain') APIFM.setMerchantId(你的商户ID) // 可以用下面的测试: APIFM.init('wxapi') APIFM.setMerchantId(9519) ``` ## 3. 调用方法 所有方法都以 `APIFM.方法名(参数)` 的形式调用,返回 Promise。接口返回的数据结构为 `{ code, data, msg }`,`code == 0` 表示成功。 ```javascript // 写法一:then APIFM.banners().then(res => { if (res.code == 0) { console.log(res.data) } else { console.error(res.msg) } }) // 写法二:async / await async function load() { const res = await APIFM.banners() console.log(res) } ``` 方法名和参数说明请查阅 [instructions.md](./instructions.md)(把文档中的 `WEBAPI.` 换成 `APIFM.` 即可)。 ## 4. 完整示例 ### 示例一:获取 Banner 轮播图 ```html Banner 示例
``` > `APIFM.banners()` 不传参数时读取全部 Banner;如果后台给 Banner 设置了分类,可传 `APIFM.banners({ type: 'index' })` 只读取该分类。 如果图片或链接字段与上面不同,请先 `console.log(res.data)` 查看实际返回的字段名。 > ### 示例二:商品列表 ```html ``` ### 示例三:手机号 + 密码登录,并读取用户信息 ```html ``` ### 示例四:调用任意接口(SDK 未封装时) ```javascript // APIFM.requestX(url, needSubDomain, method, data) APIFM.requestX('/shop/goods/category/all', true, 'get').then(console.log) ``` ## 5. 常见问题 + **提示 **`APIFM is not defined`:`