文章介绍 supermemory 团队如何将 API 从以人为中心（DX）重新设计为以 Agent 为中心（AX）。旧版 API 在 v4 时已膨胀至 41 个操作，字段冗余、命名混乱。团队从第一性原理出发重构为 v5：精简操作数量、引入 namespaces 替代 containerTag 明确作用域、支持 Markdown 响应格式、新增 /feedback 端点、遵循标准 REST 惯例、提供类型安全的统一过滤结构，并将 GET /document 从 23 个字段精简至 7 个。文章还介绍了基于单一 prompt 的迁移策略，让 agent 自动完成仓库迁移，并计划在 3-6 个月内逐步淘汰旧版本。
本文是 API 设计系列的第二部分，讲解三种突破传统请求-响应模式的 API 设计方案。SSE 是服务端单向推送通道，基于纯 HTTP，内置自动重连和 Last-Event-ID 断点续传，适合实时仪表盘和通知流；WebSockets 提供全双工双向通信，但连接有状态，需通过粘性会话或发布/订阅架构解决扩展问题，适合聊天和协作编辑；GraphQL 让客户端精确指定所需字段，解决过度获取和获取不足问题，但存在缓存困难和 N+1 查询等权衡。文章最后给出选型建议：单向推送用 SSE，双向低延迟通信用 WebSockets，灵活嵌套数据查询用 GraphQL，实际系统常组合使用。
本文系统讲解 API 设计的核心概念，聚焦资源导向设计模式及 REST 与 RPC 家族（gRPC、tRPC）的对比。作者首先介绍 API 设计的三大要素：资源、资源关系与边界，以及五种标准方法（Create、Get、Update、Delete、List）。随后分析 REST 的松耦合、JSON 传输特点及其在带宽和类型契约上的不足；gRPC 基于 HTTP/2 二进制协议和 proto 文件代码生成实现编译期紧耦合；tRPC 则面向全栈 TypeScript 项目，无需额外 schema 即可端到端类型安全。最后给出选型建议：公开 API、多客户端场景优先 REST。
