1、 文件编号 SPI-doc- TIP-PRD 作 者 黑羽文档版本 V0.6 最后修改日期 2009/1/20版本号 0.6TOP 接入系统(Taobao Intergration Platform)产品需求说明书编 写 人： 黑羽 编写时间： 2009/1/20 PRD 北京阳光创投投资咨询有限公司 非公开资料，内部交流 第 2 页 共 29 页修改记录：版本号 修改人 修改日期 审核人 批准人 备注V1.0 2016.07.20 创建确认签字：序号 版本号 内容 日期 批准人 备注1 V1.0 2345PRD 北京阳光创投投资咨询有限公司 非公开资料，内部交流 第 3 页 共 29 页目
2、录1 概述 .51.1 名词说明 .51.2 产品概述及目标 .51.3 产品 roadmap.51.4 产品风险 .62 使用者需求 .62.1 需求描述 .63 可选方案 .64 效益成本分析 .74.1 效益预测 .74.2 产品技术中心成本 .74.3 非产品技术中心的支持成本 .85 功能需求 .85.1 功能总览 .85.2 功能详情 .105.3 整合需求 .115.4 BETA 测试需求 .116 非功能需求 .11产品营销需求 .11规则变更需求 .12产品服务需求 .12法务需求 .12财务需求 .12帮助需求 .13安全性需求 .137 上、下线需求 .137.1 上线时
3、限需求 .137.2 下线需求（活动类需求必须明确下线时间） .138 运营计划 .13PRD 北京阳光创投投资咨询有限公司 非公开资料，内部交流 第 4 页 共 29 页请与以下部门讨论 PRD序号 OK？ 部门 沟通内容1. 运营中心：商城、集市、二手闲置、门户 协助设定产品的 RaodMap 协助设定 target customer：使用者 协助评估：营销/推广需求 协助设定商业目标2. 运营中心：网站运营 协助设定产品的 RaodMap 协助设定 target customer：使用者 协助评估：营销/推广需求 协助设定商业目标3. 客户中心：客服服务部 讨论客服如何支持：客服需求 协
4、助评估诈欺/数据窜改风险：欺诈 /数据窜改风险、不当使用风险 预测客服成本、工作量4. 客户中心：网络安全部 评估安全性5. 产品技术中心：系统分析师 虚拟团队 讨论以确定方案的规模评估、推出计划 进行技术可行性分析，提出关键问题的技术解决方案 评估系统规模，数据量，所需资源等 协助评估风险6. 产品技术中心：项目经理 协助确定产品发布日期 协助确定产品成本 协助评估风险7. 产品技术中心：用户体验设计之交互设计师 协助制作 Demo 协助确定 use flow：用户使用方式 8. 财务分析中心：财务组 请评估财务需求 协助评估风险9. 财务分析部：数据分析组 协助确定如何度量产品目标10.
5、行政管理中心：法务部 协助评估法务问题并检视合作伙伴：使用者数据需求、法务需求、 版权、隐私权等需求 协助评估风险：诈欺/数据窜改风险、 不当使用风险11. 规则委员会 协助评估规则变更的影响12. 支付宝 协助确定接口、合作方式等13. 阿里软件 协助确定接口、合作方式等PRD 北京阳光创投投资咨询有限公司 非公开资料，内部交流 第 5 页 共 29 页1 概述1.1 名词说明介绍本文档中会使用到的专用名词，如：新名词、产品内实体单位，请尽量使用大众可理解的名词名称 说明开放平台 以开放 OpenAPI 为核心的服务开放系统。包括开放数据、开放平台和开放的业务方入口。TOP 全称 : Tao
6、bao Open Platform, 淘宝开放平台App 应用，本文中指由第三方开发的，需要调用淘宝 TOP 来完成业务的应用程序。通常表现为浏览器端的页面插件，桌面端的应用程序。ISV Independent Software Vender， 独立软件开发商。Role 业务方角色，对应于不同的 API 访问权限和监控策略。包括：买家、卖家、高级卖家等TPS 每秒业务处理量。1.2 产品概述及目标请以三到五段文字摘要说明您所提出的新服务(包含推出新产品、现有产品重新设计或升级、现有服务推出新功能)及目标；请包括：1、 产品背景说明；淘宝开放平台是建立大淘宝的关键要素之一。以围绕淘宝开放数据和业
7、务为核心，把握商业趋势，以第三方开发软件为助力，建立繁荣的商业生态圈。对于外部数据的调用和监管，是淘宝开放中最重要的环节之一。同时，在可预见的外部数据调用大规模增长时，淘宝开放平台也必须拥有适应的机制。这些就是 TIP(淘宝接入平台)的商业背景和需求。2、 产品的目标客户；从 TIP 系统的使用来说，有外部客户和内部用户PRD 北京阳光创投投资咨询有限公司 非公开资料，内部交流 第 6 页 共 29 页外部用户：第三方开发者通过开发的 App 对 TIP 平台发出数据调用请求。内部用户：a) 开发者社区。 开发者通过开发者社区系统向 TIP 平台请求相关 App 管理接口和开发者管理接口。b)
8、 Admin Center。 AdminCenter 使用方为淘宝小二。Admin Center 主要用于管理开放平台的开发者、App、API；统计分析 TOP 数据调用的情况。1.3 产品 roadmap请描述产品发展的各个阶段，可以用图表等多种方式表述。产品发展阶段 阶段描述 时间1 满足外部数据调用的基本（P1）需求 实现基本的监控、管理功能 对 App 和开发者有最基本的管理，支持 Admin Center 对单个 ISV 单个应用手工纳入 TIP 管理体系。 Admin Center 有基本的 ISV 管理界面，和数据统计分析2009 年 3月2 完善监控与管理。 （完成相关 P2
9、需求） 。 完善 App 和开发者管理，支持对批量的 ISV 批量应用纳入 TIP 管理体系。 建立初步消息通知机制 Admin Center 完善 ISV/App 管理界面，数据统计 支持开发者社区批量接入第三方开发者2009 年 6月3 App 和开发者管理支持第三方草根开发者。 将沙箱环境使用结合进 TIP 的相关申请/管理流程 支持开发者社区对第三方草根开发者的开放。 Admin Center 完成半自动化的管理，集合对淘宝Hosting 程序的相关支持2009 年 10月1.4 产品风险请描述产品可能存在的风险，比如商务谈判的风险？外部合作的风险？不当使用的风险 等等。风险级别为高中
10、低。风险 风险级别 描述 监控策略 改善策略（/ TBD）PRD 北京阳光创投投资咨询有限公司 非公开资料，内部交流 第 7 页 共 29 页2 使用者需求2.1 需求描述请说明此产品的目标客户、其需求及使用情境。如已做好 personas(代表性角色描述)，也请包含于此。请详细说明此产品主要的使用案例目标客户最想由此产品满足什么需求？最想藉由此产品解决什么问题？并根据每个不同的使用案例，区别目标客户及其使用时的优先级/重要性/频率。目标客户 需求描述 场景描述 优先级3 可选方案列出所有可以选择的达到该产品目标的方案要点（主要思路） ，给各方案适当的评价，并推荐最优方案。如另有说明可选方案的
11、文档，欢迎使用。方案介绍 优点 缺点方案 1方案 2方案 34 效益成本分析4.1 效益预测请提供在各种产品环境中的效益预测，并标明主要的变量及假设，最好能包含现在和过去的效益数据。示例：指标 1 网游每日支付宝成交额好 中 差现状环境时间PRD 北京阳光创投投资咨询有限公司 非公开资料，内部交流 第 8 页 共 29 页产品发布后一周产品发布后 3 周4.2 产品技术中心成本请列出设计及部署此产品的产品技术中心所需的资源需求，包括人力成本，软硬件支出等。（项目经理应提供协助）示例：人力资源 工作内容描述 成本（人日） 备注产品经理交互设计师开发测试非人力资源 成本（元） 描述硬件投入软件投入
12、其他4.3 非产品技术中心的支持成本请预估此产品有关的除产品技术部以外的支持投入。比如：需要客服部投入多少的资源用于该产品的服务，需要运营部投入多少的资源运营该产品。示例：人力资源 工作内容描述 成本（人日） 备注客服专员运营专员非人力资源 成本（元） 描述广告位邮件群发PRD 北京阳光创投投资咨询有限公司 非公开资料，内部交流 第 9 页 共 29 页5 功能需求请详细说明此产品主要功能及内容(除了使用者所需的功能外，也请说明公司内部操作及维护产品所需要的功能或工具，例如报表、管理使用者或者维护网站内容的工具、客户服务工具等等。5.1 功能总览请分别列出所有重要的功能及内容模块。建议使用图表
13、来形象阐述本产品各个组成部分的关系。功能总表名称 描述 优先级 备注1. TIP Router +Gateway 淘宝接入平台网关： 分发外部程序调用淘宝业务数据的请求。 监控、记录和限制外部调用请求 主动通知应用程序信息12. Taobao Intergration Manager淘宝平台集成管理器： 提供管理开发者接口，用于监控和规范他们开发行为，并划分等级。 提供管理 App 信息接口，监控和调整 App 使用状态；与 API 调用或权限控制 提供管理 API 订购状态接口 区分 API 使用角色，和其他 TIP 子系统协作共同限制业务角色的各种权限。13. TIP Admin Cent
14、er 淘宝服务调用管理中心： 小二人工管理和调整开发者，API，APP 的后台工具 展示淘宝各项服务的调用情况的图表报告。含开发者、API 、APP 等相关数据。1Comment K1: App上架流程参考：1. ISV资格申请2. 沙箱测试3. 小二审核4. 正常发布Comment K2: 合法状态包括哪几种可能考虑：沙箱阶段正式使用阶段PRD 北京阳光创投投资咨询有限公司 非公开资料，内部交流 第 10 页 共 29 页5.2 功能详情5.1.1TIP服务接入TIP的服务接入需要处理外部业务数据请求、支持应用能够注册和侦听消息，同时还要进行业务数据调用的监控，以及对自身性能的监控。5.1.
15、1.1 业务数据请求 简要说明验证外部数据请求合法性，再将请求转发给相关 OpenAPI或内部系统。 业务规则序号 优先级 需求名称 需求描述1. 1 验证请求合法性 验证 App身份和状态 验证 App是否在 TIM中合法注册 验证 App状态是否是正常使用状态 业务方身份合法性 验证会话 session合法性 本次会话是否真实有效 会话是否过期 传入参数是否有效 验证 App请求是否越权 当前 App请求的 API与其在 TIM中注册的 API权限范围是否相符 当前 App请求的 API与终端用户在 TIM中注册的角色权限范围是否相符 验证调用方是否在黑名单中 App是否在黑名单中 域名或 IP地址是否在黑名单中 终端用户是否在黑名单中2. 四种会话验证机制 根据 App在申请时，申请的 API权限范围和使用描述，第一期由小二决定 App对应下列那一种应用方式。并和这种方式绑定。 固定时间 SessionKey当 App应用需要在固定时间内运行时，使用这一种方式授权访问时间。 根据访问延迟 Sessionkey
