
概要
上次在北京的 DevCon 上,了解到大家对 FileMaker Data API 和小程序的一些话题非常感兴趣,所以我们就来跟大家分享一些相关的入门知识。
本系列一共分为 4 篇:1. Data API 概览;2. 案例演示-调试后台 API;3. 小程序开发环境部署;4. 案例演示-调用 Data API 开发小程序。其中第一、三篇会在飞沫课公众号和我们的入门视频教程推送,第二、四篇仅在入门视频教程发布。
FileMaker Data API 真香
Restful API 其实并不是一个新鲜的技术,但是是现在最通用的技术之一。在开放的互联网中,各种系统都通过 API 进行标准化对接。
我们在之前的公众号中也介绍过如何在 FileMaker 中调用其他系统的 API。但是,今天我们要说的是如果将 FileMaker 中的数据通过 API 输送给其他系统。这里,我忍不住要夸一下 FileMaker。正常来说要给一个系统增加对外分享数据的 API,需要数名具备 API 开发能力的高级后端开发者,花费很久的时间才能完成。但是,在 FileMaker 提供了基础 API 之后,我们只要改一改脚本,就完成了 API 接口组的开发。我个人认为在5-500人并发、年500万记录、无原生软件顺滑体验洁癖的需求场景下,FileMaker 的优势巨大。
了解 Data API 大类
FileMaker Data API 的文档随 Server 一起安装,当我们部署好服务器、域名、SSL 数字证书之后,可以在以下网址访问:https://{域名}/fmi/data/apidoc/。暂时没装的,可以下载从我们服务器拷贝出来的离线版。
链接:https://pan.baidu.com/s/1hy_H3d1HB78gsDpAmbW0ig 密码:gnqi
FileMaker 提供的 6 大类 API:

- metadata(元数据获取):这个部分的 API 主要给外部开发者参考,内部开发者对这些信息了如指掌,几乎不需要。
- auth(登录验证):登录验证是必须的步骤,先通过 basic auth(用户名和密码)获取 access token,然后再通过 token 授权给后续 API。当然这里还支持 Google、微软的 OAuth,国内几乎不用,所以不讨论。
- records(记录操作):这里提供了完整的获取、增加、修改、删除、查找、复制等记录的操作,不过我个人觉得用处一般。因为当我们去进行这些记录操作时,都是带有上下文场景的,即需要通过脚本来完成。所以,我们更多的情况是使用 script API,少量使用 records API。
- scripts(脚本执行):这个 大类下只有一个『执行脚本』API,但是这是所有 API 里最重要的。我们本身具备的编写复杂脚本的能力,搭配『执行脚本』这个 API,就可以轻轻松松让前端开发者获取任何想要的数据。这个 API 让 FIleMaker 开发者原地获得了开发复杂 API 的技能。
- container(容器上传):作用如名,需要就用。
- globals(设置全局字段):作用如名,需要就用。
经过分析可以发现:当我们使用 Data API 开发小程序时,小程序只是完成了界面的渲染,逻辑计算的大部分工作都转移到服务器上进行。这跟原来使用 FileMaker 有一点区别,所以这时候选择服务器配置时,需要比原来只托管 FileMaker 的硬件配置更高。
阅读 Data API 文档
要了解一条 FileMaker API 的用法,主要需要关注以下几个方面:方法(HTTP 请求方法,分为:GET、POST、DELET、PATCH等)、路径(PATH)、地址参数(PATH PARAMETER)、头部(HEADER)、正文(BODY)、响应(RESPONSE)。
这几个部分已经全部标注到图中,请点击放大查看。

下面我们通过 cURL 方式登录和新建记录两个过程来给大家演示一下 FileMaker Data API 的应用。


下一篇(2周内),我们会介绍将要开发的案例。以及对此案例所用的 API,逐一用第三方工具先进行调试。

请入门视频教程的用户后续到各自的频道查看。没有购买的用户,可以点击下面链接访问
https://study.163.com/course/introduction/1209571923.htm