我们正在开发一个 REST API,除了开发人员可以访问的各种资源之外,我们的应用程序还会将信息发送到客户端服务器上的侦听器脚本。
我们的 API 文档列出了客户端应用程序可以访问的所有“资源”。那部分很容易。
但是我们应该如何列出我们的应用程序将 POST 内容到客户端侦听器脚本的各种 %???% 呢?
作为开发人员,您希望如何命名这些 %???%?
谢谢
注 1:我使用 %???% 因为我不知道如何称呼它们。注2:我第一次发布到stackoverflow,如果我没有遵守协议,请道歉。
编辑
抱歉,不清楚。
我们的 API 接收来自客户的请求。它还向客户端发送请求。
例如,当客户端收到一条消息时,我们会将该消息发送到他们的服务器。或者,当他们之前发送的其中一条消息的状态已更新时,我们会将更新发送到他们的服务器。
或者,以 Twitter 为例(假设我们是 Twitter),当你在一条推文中被提及时,我们将这条推文的详细信息发送到你的服务器
当客户端向我们的 API 发送请求时,这被描述为“访问资源”并且文档列出了“资源”。
但是当我们的 API 向客户端发送请求时,我们怎么称呼它呢?例如 API 发起的方法?