关于APP开发中API接口您需要了解的事

一、API是什么？

API是应用程序编程接口，如何理解呢？

API就好像是一个传输数据的通道，入口需要请求数据，就好像是通关密码，而出口需要返回结果。

接口的使用方不需要关心接口是如何实现的，他只关心能不能拿到接口最后的返回结果。

接口的提供方需要定义接口请求参数、响应内容等，还需要关注接口的性能，是否能满足高并发的调用，接口的稳定性如何……

二、如何理解接口

API接口是Application Programming Interface的简称，是一些预先定义的函数，包括接口地址、传入参数和返回参数。

可以简单理解为，当需要访问某些数据，正常状态下传入合格参数，会收到该数据范围内的返回参数。

场景：在美团旅游频道，用户选定时间、地点后搜索航班，后台会调用搜索接口传入时间、地点等参数，接收航班类别、价格等参数，在前台页面上进行排列展示。同理，下单时会调用生单接口确认是否成单，支付时会调用支付接口完成交易，自动修改订单状态。

三、如何看懂接口文档

接口一般分为以下几个部分：

1、接口描述

简单描述接口的逻辑和作用

2、接口地址

接口的正式url和接口测试的url，需求方通过调用接口url，获取响应内容

3、请求方法

一般来说，接口最常见的请求方法为GET和POST两种方式，即读接口和写接口。通过这两种方式，实现对数据的增删查改。增删改本质都是写的动作。

4、请求参数

即需要请求的字段名的名称和规则：

都是哪些字段，字段的类型是什么，是否必填字段等等

5、响应内容

接口返回的字段名称和规则

注意：大部分开发往往不会把所有的字段罗列，只会列出比较重要的字段。

当你发现，接口文档中没有你需求的字段，别着急找开发，可以看下实例中，有没有需求的字段。

比如这个文档，你可以很明显的发现，响应内容中缺少了数据写入状态这个字段，但是在后续实例中，是包含has sucess这个字段的。

6、错误代码

对接口的错误用代码进行归类，以便能快速找到错误原因，解决问题。

7、实例

实际调用时的响应的内容。

四、举例说明：如何基于微信开放接口开发企业的微信CRM

企业要开发微信 CRM，首先要从业务架构上进行设计清楚。微信 CRM 的本质，是在微信渠道上利用微信的特点和接口而扩展的 CRM 系统。而 CRM 系统，一般可以分为五大模块：客户、销售、营销、服务、会员，另外还有一些附属模块：产品、知识库、活动、交易、统计报表等。在确定微信 CRM 的业务架构后就可以进一步设计具体的数据模型、功能模块和接口对接了。

1.客户管理模块

客户管理主要是微信 CRM 进行客户信息管理、客户分级分类、客户沟通关怀和客户生命周期管理的基础模块。

客户信息管理可以通过获取用户基本信息接口建立基本的客户信息档案，通过获取用户地理位置接口获取客户的位置信息，只是需要建立位置轨迹管理，而不是简单的坐标位置储存。通过关注订阅事件和取消关注事件，记录客户的关注时间和取消关注时间。

针对公众号已有的关注者，可以通过获取关注者信息接口批量获取公众号粉丝，该接口每次获取 10000 条，几个循环就可以把品牌公众号上的粉丝导入到微信 CRM 进行管理。 客户分类可以基于用户分组接口，实现公众号的分组与微信 CRM 的分组同步，客户分类后形成目标列表，是营销活动的目标对象，也是客户服务差异化的基础。

客户生命周期管理，基于客户的关注时间、取消关注时间以及当前的微信互动频率、微信互动信息方向等，建立一个粉丝的生命周期管理。

2.服务管理模块

服务的本质是客户发起一个请求、品牌来进行响应和 反馈，循环往复直至客户满意。 初步原来是基于接收用户消息和向用户回复消息接口实现微信的收和发，但由于六秒的限制很多客户服务动作来不及做完。因此，客户服务接口出现了，它可以实现 在 24 小时内回复，这样微信 CRM 可以轻松走完内部处理动作而实现对客户的微信请求的响应或答复。

客户服务管理还需要接收事件推送接口和自定义菜单，实现客户的多触发机制，这样客户可以通过自定义菜单、消息等各种方式随时发起微信请求。

但是微信客户服务最难的不是功能设计和开发，而是对微信客户服务运营的理解。微信 CRM 不仅仅是系统，更是运营，因此你如何设计微信客户服务运营的流程和 KPI？这个很关键。根据你的流程和 KPI，微信 CRM 怎么来支撑？比如当前企业的微信主要指标是到达数量、打开率、转发分享率等，但是对于客户服务而言，这个根本不足够。微信客户服务需要的是响应时间、服务 水平、反馈周期、解决率等专业指标。

3.营销管理模块

微信 CRM 的营销管理的核心是，建立拉式营销而不是推式营销。因此，建议品牌尽量放弃那种一天一推的轰炸模式，而是设计吸引客户主动触发的拉式营销。从这个角度上讲，基于消息模板单发消息接口应该限制，或者限制批量群发营销，鼓励一对一的客户事件触发的下行模板消息。

营销管理需要用到的是事件推送接口、发送位置消息接口、自定义菜单接口和扫一扫功能，通过客户触发的时间、发送的消息、点击 自定义菜单以及扫码，让客户进行具体的营销活动。比如关注订阅事件触发一个最新优惠活动的下行消息、发送位置消息签到下行一个特定活动，或者点击相关活动 菜单进入到营销活动的页面或者链接。

微信 CRM 可以让客户扫描二维码进入到营销活动页面。还可以通过带参数的二维码，标识这个市场活动的营销代码，客户扫码可以识别来源，这样在微信 CRM 中实现市场活动—线索的响应反馈闭环。

拉式营销的主要形态基本上就是 O2O，只是需要与业务运营进行融合，实现常态化。但要看企业是不是能够真正做到重构？比如日常的营销活动，必须从微信运营部门会签，看每一个营销活动是否可以增加微信元素？

4.微信呼叫中心

从客户服务模块延伸出来一个呼叫中心模块，为什么把微信呼叫中心单独拎出来专门讲？是因为呼叫中心是大 CRM 的一部分，但是又因为业态特殊所以独成一体。针对呼叫中心的设计，比较特殊，而且可以用在客户服务上，也可以用在销售外呼上，甚至来进行营销活动的预热或 者邀约等。

由于一对一的主动单发是受限的，因此微信的销售模块就不单独设计了，部分功能而是融合在微信呼叫中心里面。

微信 CRM 的呼叫中心模块，可以基于自定义菜单接口，实现呼叫中心的 IVR 交互菜单，同时再单独开发模块实现多用户和智能分配，实现不同菜单分配到不同用户或用户组，这是呼叫中心最基本的 IVR 和 ACD。

由于呼叫中心多语音的特点，以及座席客服都是声音甜美，所以需要通过语音识别接口实现对语音微信呼叫的识别和转换，同时通过多媒体文件接口实现微信语音呼叫的备案（专业术语叫录音系统）和质检功能，并可以通过多媒体文件接口回复实时的或者预录制好的语音。

微信 CRM 的呼叫中心模块偏重于微信客服坐席的运营管理，最难的也是业务设计而不是系统。比如微信座席是与传统座席混排还是独立？这直接涉及到呼叫中心模块的设计。