服务调用API参考

Dapr为用户提供了使用唯一命名标识符（appId）来调用其他使用Dapr的应用程序的功能，或者调用不使用Dapr的HTTP端点。 这使得应用程序可以通过命名标识符相互交互，并将服务发现的责任交给Dapr运行时。

调用远程Dapr应用上的方法

这个端点允许您在另一个启用了Dapr的应用中调用方法。

HTTP请求

PATCH/POST/GET/PUT/DELETE http://localhost:<daprPort>/v1.0/invoke/<appID>/method/<method-name>

调用非Dapr端点上的方法

这个端点允许您使用HTTPEndpoint资源名称或完全限定域名（FQDN）URL在非Dapr端点上调用方法。

HTTP请求

PATCH/POST/GET/PUT/DELETE http://localhost:<daprPort>/v1.0/invoke/<HTTPEndpoint name>/method/<method-name>

PATCH/POST/GET/PUT/DELETE http://localhost:<daprPort>/v1.0/invoke/<FQDN URL>/method/<method-name>

HTTP响应代码

当一个服务通过Dapr调用另一个服务时，被调用服务的状态码将返回给调用者。 如果存在网络错误或其他瞬态错误，Dapr将返回一个500错误，并附带详细的错误信息。

如果用户通过HTTP调用Dapr与启用gRPC的服务通信，来自被调用gRPC服务的错误将返回为500，而成功的响应将返回为200 OK。

URL参数

注意，所有URL参数区分大小写。

请求内容

在请求中，您可以传递头信息：

{
  "Content-Type": "application/json"
}

在请求体中放置您想要发送给服务的数据：

{
  "arg1": 10,
  "arg2": 23,
  "operator": "+"
}

被调用服务接收到的请求

一旦您的服务代码在另一个启用了Dapr的应用或非Dapr端点中调用了方法，Dapr会在<method-name>端点上发送请求，并附带头信息和请求体。

被调用的Dapr应用或非Dapr端点需要监听并响应该端点上的请求。

跨命名空间调用

在支持命名空间的托管平台上，Dapr应用ID符合包含目标命名空间的有效FQDN格式。 例如，以下字符串包含应用ID（myApp）以及应用运行的命名空间（production）。

myApp.production

支持命名空间的平台

• Kubernetes

示例

您可以通过发送以下内容来调用mathService服务上的add方法：

curl http://localhost:3500/v1.0/invoke/mathService/method/add \
  -H "Content-Type: application/json"
  -d '{ "arg1": 10, "arg2": 23}'

mathService服务需要在/add端点上监听以接收和处理请求。

对于一个Node应用，这将如下所示：

app.post('/add', (req, res) => {
  let args = req.body;
  const [operandOne, operandTwo] = [Number(args['arg1']), Number(args['arg2'])];

  let result = operandOne + operandTwo;
  res.send(result.toString());
});

app.listen(port, () => console.log(`Listening on port ${port}!`));

来自远程端点的响应将返回在响应体中。

如果您的服务监听在更嵌套的路径上（例如/api/v1/add），Dapr实现了一个完整的反向代理，因此您可以将所有必要的路径片段附加到您的请求URL中，如下所示：

http://localhost:3500/v1.0/invoke/mathService/method/api/v1/add

如果您在不同的命名空间中调用mathService，您可以使用以下URL：

http://localhost:3500/v1.0/invoke/mathService.testing/method/api/v1/add

在此URL中，testing是mathService运行的命名空间。

非Dapr端点示例

如果mathService服务是一个非Dapr应用程序，则可以通过HTTPEndpoint以及完全限定域名（FQDN）URL进行服务调用。

curl http://localhost:3500/v1.0/invoke/mathHTTPEndpoint/method/add \
  -H "Content-Type: application/json"
  -d '{ "arg1": 10, "arg2": 23}'

curl http://localhost:3500/v1.0/invoke/http://mathServiceURL.com/method/add \
  -H "Content-Type: application/json"
  -d '{ "arg1": 10, "arg2": 23}'

下一步

• 如何：调用和发现服务