如何调用API

本文为您介绍如何调用火山引擎 E-MapReduce（EMR）OpenAPI。

1 请求结构

火山引擎 EMR OpenAPI 的请求结构包含如下信息：

1.1 请求域名：

火山引擎 EMR OpenAPI 的域名为 open.volcengineapi.com。

1.2 通信协议

火山引擎 EMR OpenAPI 支持通过 HTTP 或 HTTPS 两种方式进行请求通信，推荐使用安全性更高的 HTTPS 方式发送请求。

1.3 请求方法

火山引擎 EMR OpenAPI 支持 GET 和 POST 请求方式。

1.4 请求参数

火山引擎 EMR OpenAPI 请求参数包含两类参数：

• 公共请求参数：需在每个请求中都必须包含，详见：公共参数。

• 接口请求参数：接口请求参数需参考各个服务的接口文档，详见：API 说明文档。

1.5 字符编码

请求及返回结果使用 UTF-8 的字符集进行编码。

2 公共参数

所有接口请求中都必须携带公共参数，为了避免重复说明，本文中不再重复描述这部分参数，请您在请求 API 时携带这部分参数，否则请求将无法通过合法性验证。

公共参数说明详见：公共参数。

3 签名方法

火山引擎 OpenAPI 为保证请求者身份的合法性以及请求在传输过程中不被恶意篡改，火山引擎签名机制要求请求者对请求参数进行哈希值计算，经过加密后同API请求一起发送到服务器中，服务器将以同样的机制对收到的请求进行签名计算，并以此与请求者传来的签名进行比对，若签名未通过验证，请求将被拒绝。

具体计算签名方法，请详见：签名方法。

4 返回结果

以请求 CreateCluster（创建集群）接口为例，返回成功结果示例如下：

{
    "ResponseMetadata": {
        "RequestId": "20211230204359010225243125031xxx", 
        "Action": "CreateCluster", 
        "Version": "2022-06-30", 
        "Service": "emr", 
        "Region": "cn-guilin-boe", 
        "Error": null
    }, 
    "Result": {
        "OrderId": "Orderxxxxx",
        "ClusterId": "emr-12345"
    }
}

5 公共错误码

更多公共错误码详见：https://www.volcengine.com/docs/6369/68677