18、超媒体服务API设计与实现指南

超媒体服务API设计与实现指南

1. 客户端逃脱机制与数据异常处理

在某些情况下，客户端需要有逃脱循环的机制，且这个逃脱值应由客户端完全控制。若依赖其他服务来决定是否逃脱，当远程服务不可用或向客户端发送错误数据时，可能会导致失败。

以温度监控应用为例，若返回传感器数据的服务出现故障或不可用，客户端不应盲目持续检查，而应添加代码，在传感器无响应或报告的数据超出预设边界时触发警报。

2. 服务API设计的挑战与目标

服务API设计和实现的主要挑战是平衡可用性和可演进性。API不仅要清晰易懂，还需便于未来修改，且要保证长期可靠性。

HTTP协议的设计是一个很好的示例，其几乎所有关键方面都可修改，如HTTP方法、状态码、URL、可能的头部列表和可能的主体格式等。HTTP消息结构保持一致，内容却可变，这是创建稳定、有价值服务API的关键。

3. 超媒体服务API的特点

• 运行时操作元数据 ：这类API的关键特性是能够在运行时包含操作元数据，而非仅依赖设计和构建时的描述。通过遵循HTTP协议设计模式的超媒体格式，可在运行时修改消息。
• 内容协商 ：成功实现服务接口的另一个关键要素是通过内容协商支持多种表示格式。

4. 发布至少一个稳定URL

• 问题 ：如何为服务API建立稳定的网络位置（URL），并确保即使底层服务迁移到新位置，API仍可被找到？
• 解