API 接口有哪些：六个层面判断平台的开放深度

## API 接口有哪些：六个层面判断平台的开放深度

"支持 API 对接"这句话，现在几乎每个营销平台都会写。出现频率太高，已经不太说明问题。真正决定你能不能把活动接进现有系统的，不是"有没有接口"，是**接口能覆盖到哪一层**。

**本文换个问法评估开放能力：不问"有没有"，问"覆盖到哪一层"。**

**适用对象**：正在评估营销平台接入方式的企业市场负责人与技术负责人。

## 一、"有接口"和"能对接"之间，差着一段路

"有接口"通常指的是**能拿到数据**：活动结束把名单导出来，或者通过接口拉一次，单向、事后。"能对接"指的是**活动能在你的系统里跑**：用户登录一次就被认出身份，参与记录写进会员档案，中奖后原有系统能接着发权益，双向、实时。

这个区别值得较真，因为它决定活动的经验能不能回到你自己的系统。只能导出名单的话，每场活动都是孤立的，做完就散，下次从零开始。**能双向对接的活动，每做一次都在往你的数据里加东西。**

判断方法很简单，看接口的方向：只能读的，是数据出口；能读也能写的，才叫对接。

## 二、六个层面，逐个问清楚

一个平台把开放能力组织成哪几层，决定了它能接进你系统的哪一部分。下面这种划分从"账号"排到"移动端"，每一层回答的都是具体的业务问题，不是技术名词。

这六层里，前三层对应的是内部角色：基础集成是技术负责人的问题（账号能不能统一），管理集成是运营和行政的问题（员工离职、部门调整后权限要不要重配），编辑器集成是内容团队的问题（素材模板能不能在自己系统里调用）。后三层更贴近业务：互动集成决定玩法能不能被业务触发，服务集成决定你还要不要再找一家短信、收款的供应商，移动端集成决定活动在 App 里是"外链"还是"接近原生"。

这六层不必每层都接满。判断需要哪几层有个简单办法：**列出这次活动要牵动你系统里的哪些东西**，牵动到哪几项，就对应到哪几层。易企秀的开放平台正是按这六层组织接口的，从账号打通到移动端嵌入各有对应方案。

## 三、三种要警惕的"伪开放"

接口文档越厚越容易让人放心。但有几类"开放"，名字上没错，用起来会发现接不进业务。

**"只有导出"最容易被误当成够用**，因为日常确实只用到导出。等某个场景需要"用户一参与就立刻发券"，才发现出口是单向的。**"只有单向"的问题类似，数据进得来出不去**，需要联动的玩法就做不成。这两类都可以问一句来判断：**你们的接口能不能由外部系统触发一个动作。**

**"只有链接"看着省事，代价最容易被忽略。** 链接能发给用户，但嵌不进你的界面，用户要在两层界面之间跳。判断这一点，看平台给的是嵌入形态还是只有分发形态。

## 四、对接之前，自己要先备好三样

这一节常被跳过，但对接顺不顺利，有一半取决于甲方自己。同样一套接口，有团队两周接完，有的要两个月，差别多半在这三样上。

**三样里最容易漏的是字段口径。** 同一个词在两个系统里含义常常不同，活动平台说的"完成"是走完全部流程，你的系统里可能是"提交了表单"，混在一起就出错，开工前就该写成一份说明。**匹配键决定数据能不能归位**，用手机号还是会员 ID，要从你系统里最稳定的字段出发，选错了接过来就是一堆对不上人的记录。

接口这一侧的能力够不够，最终要拿一份清单逐条确认。易企秀的开放平台在对接阶段提供接口说明，可以对照上面的问题逐层核对。

## 五、一份对接前的问询清单

把上面几节收敛成一份可直接使用的清单，评估时逐条问，比看宣传材料有效。

**开放深度：** 接口的方向是只能读还是也能写；能不能由我方系统触发活动里的一个动作；有没有可嵌入的形态，而不只是可分享的链接。

**我方准备：** 关键字段的定义是否有书面口径；匹配键是否已确定；双方是否各指定了对接人与验收人。

清单不必追求"全都有"，但**"全是导出""全是单向"命中一条，就要重新想清楚这次合作能不能满足你的场景**。到这里会发现，真正要比较的不是接口数量，是接口的方向和层次，这也是易企秀开放平台按六层组织能力的用意。

*本文为方法参考，具体优化动作请结合自身数据基线与用户特征判断。*