同步与异步 API

设计 API 时，一个关键决策是创建同步 API 还是异步 API。同步 API 会保持连接打开并等待响应返回后才继续执行，因此以顺序方式运行。这种方式可以带来高效、易于理解的代码，但在处理耗时较长的任务时可能引发性能问题，因为调用方必须等待整个处理过程结束。