# apifm介绍
[apifm packages 官网地址](https://github.com/gooking/apifm-flutter)
[apifm packages 国内镜像地址](https://pub.flutter-io.cn/packages/apifm)
[github 项目地址](https://github.com/gooking/apifm-flutter)
# 为什么要使用 apifm
apifm 是 Flutter 的云开发插件，使用该插件开发 app ，你将不再需要额外开发 api接口，无需开发后台管理系统，无需购买昂贵的服务器资源，为你节省的不仅仅是以上开发工作量和研发成本，更重要的是：
**apifm 插件的功能都是经过无数严苛的生成环境验证成熟稳定的，能为你节约测试成本、试错成本、项目上线的时间成本**
使用了 apifm ，你现在的 app 开发流程将会是这个样式的：
~~1. 购买服务器，用来运行后台及接口程序；~~
~~2. 购买域名，App 通过域名来调用服务器的数据；~~
~~3. 购买 SSL 证书，传统 http 请求被认为是不安全的，https 是主流；~~
~~4. 后台程序员开发后台程序，这样才能登录后台进行商品管理、订单维护、资金财务管理等等；~~
~~5. 后台程序员开发App可用的 api 接口；~~
~~6. 开发的后台及接口程序的安全性、功能性、稳定性测试，bug调试完毕；~~
7. UI 设计师设计精美的App界面；
8. 前端工程师根据 UI 设计稿进行App开发、同时对接 api 接口完成最终开发；
# 使用方法
## 项目添加依赖
pubspec.yaml 文件中增加依赖：
```yaml
dependencies:
apifm: ^0.0.2
```
然后安装该插件：
```shell
flutter pub get
```
## 引入 package
```plain
import 'package:apifm/apifm.dart' as Apifm;
```
## 初始化
```javascript
Apifm.init("gooking");
```
_gooking_ 为你的开发者后台的专属域名，登录你的开发者后台，在后台首页即可查看属于你的专属域名「默认情况下为32个字母长度的字符串」
[>> 前往免费注册开通开发者后台](https://www.it120.cc/)
## 调用api接口
这里以查询手机号码归属地(queryMobileLocation)的调用后台接口为例子说明如何在 Flutter 中使用 apifm ，其他接口，你可以根据使用文档的说明调用相应的方法即可
### await 方式调用：
```javascript
var res = await Apifm.queryMobileLocation("13500000000");
print(res);
```
### Future 异步方法:
```javascript
Apifm.queryMobileLocation("13500000000").then((res) {
print(res);
});
```
# 返回值说明
返回数据 (**res**) 主要包含 3 个内容：
1. code 错误码，0 代表操作重构，其他数字均表示错误，具体错误描述请查看 msg；
2. msg 如果上面的code不为0，那么 msg 将会返回具体的错误说明描述
3. data 字段保存了 code 为0 时候的数据，一起你需要的数据，都保存在 data 中返回给你
# 相关资源
[「功能说明文档」](https://github.com/gooking/apifm-flutter/blob/master/instructions.md)
[「api接口文档」](https://api.it120.cc/doc.html)