开放平台的产品经理到底是做什么的

对于B端、C端或后台产品来说，产品、开发和运营的职责基本很清晰很明确，但对于开放平台这样的一个看起来很技术的产品来说，产品经理和开发之间的职责划分就很模糊，而且也没有业界样板来参考，所以这个问题一直都困扰着我。

在讨论分工之前，我们先看下在规划一个开放平台类的产品到最终上线，大概需要经过哪些步骤，需要做哪些工作。

上面这么多的步骤中，大体可分为4个阶段，分别是：需求阶段、设计阶段、开发阶段和运营阶段。每个阶段的工作大体如下：

需求阶段：这个阶段主要的工作是确定开放平台的定位以及一些潜在需求的收集和分析，这一步其实和最后的运营推广有很大的相关性。我们的定位是什么决定了用户是谁，解决他们的哪些需求，才能指导后期的推广和运营。另外在这一阶段，也需要根据需求来确认开放的服务范围，哪些开放，哪些不开放，开放到什么程度都是这个阶段需要做的事情。

设计阶段：这个阶段主要需要将需求阶段的想法转化成方案输出，可能会涉及到流程设计、接口设计、契约设计，包括为了建设生态而做的wiki、应用管理、沙箱环境等一系列工作。这个阶段的工作最为复杂，也最为繁琐，需要平衡 ISV 和内部，这个阶段的好坏直接决定了开放平台该版本推广的顺利与否。

开发阶段：传统的开发流程归入到了这一阶段，这个阶段包括了系统架构的设计，开发、测试等，需要注意的是不同于普通的产品，开放平台的产品没有界面，而且是纯程序无人工的方式进行调用和处理，一旦出现错误或性能的问题将是灾难性的。比如某家ISV系统由于设计问题，频繁调用平台方接口，如果没有做相关的限流或接口调用限制的话，可能会造成整个平台相关功能的不可用。所以在平台的系统设计阶段，就应该把安全性、性能、监控等方面考虑完整，不能走一步算一步。当然这方面重点还是需要架构师去考虑。

运营推广阶段：如果开放平台配置了相应的运营人员，那么产品经理和运营配合好，慢慢的吸引一些ISV入驻，并引导他们做出能更好的满足用户需求的工具或服务。

那么以上四个阶段中哪些是产品经理的职责呢，我的想法是需求阶段，设计阶段都是，如果开放平台没有专门的运营，那么运营推广阶段也应该产品经理负责。

在这方面，可能部分同学对设计阶段的接口、契约字段设计工作有异议，觉得这是开发人员的工作。的确在很多公司这两块是开发人员主导，甚至一些细粒度的接口流程都是开发定义。但这样其实并不太合理，我们不能因为一件事情看起来偏技术就觉得这应该分配给开发人员，而应该从这项工作的本质来安排。

对于普通的C端产品，用户的页面、页面间的跳转、页面上的字段，以及操作交互都是产品经理主导。而开放平台的产品，接口就像是页面，契约就像是页面上的字段，多接口的相对关系就像是页面间的跳转逻辑。所以从这个角度看，接口和契约设计还应该是开发人员主导么？

另外我们假设由开发人员来设计接口和契约，可能会出现什么情况呢？

1. 没有按照用户场景来设计接口。开放平台的接口最终是用来让ISV接入，解决的是真实场景的用户需求，而我们并不可能要求开发人员有用户思维，所以可能的结果是接口设计原则是按照内部接口甚至是数据库的结构来设计的。

我们先看下苏宁易购的开放平台商品API的接口设计，如下图：

首先从接口排序、接口命名到接口解释等都比较随意，很多接口是做什么的，以及它和其他接口的关系不能一眼就看出来，而且有很多类似但又不同的接口，比如“商品内容维护”和“商品内容修改”，这是一个门槛很高的接口设计，需要深入了解苏宁易购的业务逻辑和数据结构才有可能理解这些接口的含义。

相比之下，淘宝的接口设计就规范的多，如下图：

对比之后，你可能发现，淘宝的接口排序、命名、设计都要比苏宁规范、正常的多，即时你不是一个电商的产品经理，你也能看懂个大概，这就是一份好的接口设计带来的不同。

2. 接口、契约字段命名不统一，不好理解。命名问题一直困扰着程序员，从驼峰命名法，到Pascal命名法，再到下划线命名法，目前开放平台基本形成了接口使用半角句号连接(如taobao.product.add)，字段使用下划线连接的命名方法（sale_props），如果你还是坚持用其他的命名方法就会有点奇怪了。

另外命名的问题还有前后不统一，比如新增一会儿用add，一会儿用create；数组的命名一会儿用List，一会儿用s形式的复数形式。现在回过头去看看苏宁的api接口的命名，你会发现惨不忍睹。。。

当然这两块非常考验产品经理的技术功底，这也是为什么开放平台的产品经理很多都是技术出身的原因。如果实在不太会技术方面的东西，首先需要尽可能的补充一下技术相关的基础知识，同时花多一点的时间去研究竞品的接口和契约设计，最后找一个靠谱的懂业务的开发帮助你一起完成这块的工作。

好了，本次我们讨论了开放平台的产品经理的职责范围，并重点讨论了接口和契约设计，这些都是我的个人观点，如果有疑义可以在下面留言，特别希望同样是开放平台的产品经理能不吝赐教。

作者：凯少Kevin

博客： http://www.jianshu.com/users/63e14c8782f2/latest_articles

本文版权归作者和简书共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。