php - 开发 Web 服务时可能遇到的一些陷阱/技巧是什么

Question

希望使用 PHP 开发网络服务 (api)，以便为客户提供一种更简单的方式来与我们的平台集成。有一些工作流调用将通过用户/密码以及一些报告选项进行验证。

抱歉，我无法发布有关该主题的更多详细信息或代码，而且我从未开发过 Web 服务，但有通过 SOAP 使用它们的经验。

现在我还需要提供工作流的状态，我认为 REST 是最好的选择，但仍在征求意见。

对于报告，我想提供不同的选项，例如 XML、Excel/CSV，我有什么理由要选择一个而不是另一个吗？

我应该注意哪些陷阱？

任何人都可以提供哪些 gem 。

在此先感谢您的帮助，因为这对我来说非常重要。

更新#1:

• 最安全的方法是什么？
• 最灵活的方法是什么(独立于平台)

更新#2:关于数据流的一点点。每个用户都有使用 API 的凭据，用户之间不共享任何数据。用法是提交请求，处理请求并返回。没有更新。 (想想谷歌)发出搜索请求并给出结果，但在我的例子中只给出了一个结果。不知道是否需要，所以仅供引用。

Answer 1

Always handle errors and exceptions.

问题总是会在应用程序/API 中出现。无论是在开始还是通过进一步发展。不要将此作为结束任务，并在发生错误时明确说明，并提供详细记录的响应消息。

此外，如果您的服务将处理许多请求，并且对于相同的资源 ID(独立于用户)返回相同的资源，请务必缓存信息。这不仅是出于性能原因，也是针对错误出现的情况。通过这种方式，您至少可以为客户提供一些服务(可能有用，需要更多明确的上下文)。