操盘手年鉴The Operators’ Almanac
PD · FW · 643

Web 架构与 API 基础

Web Architecture And Api Fundamentals · web-architecture-and-api-fundamentals--become-a-more-technical-product-manager
产品方法论 框架 过渡期 2024-03 Colin Matthews ✓ 已核验出处

解决什么问题

PM 缺乏技术背景,难以理解产品架构和 API 运作方式,导致与工程师沟通成本高、决策易出现偏差。

核心内容

绝大多数软件产品由三层基础架构组成:

  1. Client(客户端):终端用户使用的网站或 App。
  2. Server(服务端):处理客户端发出的请求。
  3. Database(数据库):永久存储数据。

客户端通过 API 与服务端通信。API 是服务端的“前门”,定义了可供调用的动作或资源(即 endpoints,如 /listings)。 常见的 API 设计模式有三种:

  • SOAP:遗留设计,多用于医疗和金融服务。
  • REST:最流行的设计模式。常用请求类型包括 GET(获取数据)和 POST(提交新数据,通常附带 body)。
  • GraphQL:由 Meta 创建的较新模式,多用于应用内部的私有 API。

一个典型的 REST 请求包含:Base URL(基础地址)、Endpoint(具体资源)、Query parameter(查询参数)。

适用边界

适用于需要看懂技术文档、与工程师对齐实现方案的 PM。作者强调这只是基础概念,实际的大型系统会远比这复杂。

关键引述 · 原话

"The API is the server’s front door-it’s the set of actions that are available to clients." (Colin Matthews)

关联卡片

是理解软件开发生命周期(SDLC)中实现与测试环节的基础。

出处Colin Matthews · 02-newsletters/become-a-more-technical-product-manager.md
提炼自 Lenny Rachitsky 的 Lenny’s Newsletter & Podcast(2019–2026)。本站为个人学习用途的二次创作,与 Lenny’s Newsletter 无官方关联。
provenance · 已核验 · glm-5.2