服务地址
火山引擎 OpenAPI 的通用服务接入地址如下：

通信协议
所有接口均使用安全性更高的 HTTPS 方式发送请求，提供高安全性的通信通道。
请求方法
OpenAPI 仅允许使用 POST 请求。

请求参数
火山引擎 OpenAPI 请求包含两类参数：
• 公共请求参数：每一个接口需要包含的请求参数。详细信息，请参见 公共参数。
• 接口请求参数：各个接口特有的请求参数。详细信息，请参见各个接口文档。
字符编码
请求及返回结果使用 UTF-8 的字符集进行编码。

公共请求参数是每个接口都需要使用的请求参数，开发者每次使用火山引擎 OpenAPI 发送请求时都需要携带这些公共请求参数，否则会导致请求失败。公共请求参数首字母均为大写，以此区分其他请求参数。
Action 和 Version

签名参数

在Header中的场景

Authorization 中的信息含义：

火山引擎对于每一次的 HTTPS 协议访问请求，会通过访问签名信息中的访问密钥（包括 Access Key ID 和 Secret Access Key），验证访问请求者身份。
获取访问密钥
账户和有权限的用户可以新建访问密钥，操作如下：

1. 使用主账号或拥有密钥管理权限的 IAM 用户登录 [访问控制控制台](https://console.volcengine.com/iam)。
   

2. 在左侧导航栏选择 **资源管理 > 密钥管理**。
   

3. 查看您账号的访问密钥列表。
   

   ￮ 每个账号最多同时拥有 2 个访问密钥。
   ￮ 如果当前账号的访问密钥数量未达到上限，则可单击 新建密钥，创建新的访问密钥。创建完成后单击 查看AccessKey详情，查看新的访问密钥信息。

创建一个正规化请求

CanonicalRequest = HTTPRequestMethod + '\n' + CanonicalURI + '\n' + CanonicalQueryString + '\n' + CanonicalHeaders + '\n' + SignedHeaders + '\n' + HexEncode(Hash(RequestPayload))

在签名之前，要将请求正规化，使得签名计算过程无异议，其主要过程及伪代码如下：

CanonicalQueryString = "Action=ListUsers&Version=2018-01-01"

CanonicalHeaders = CanonicalHeadersEntry0 + CanonicalHeadersEntry1 + ... + CanonicalHeadersEntryN

CanonicalHeadersEntry = Lowercase(HeaderName) + ':' + Trimall(HeaderValue) + '\n'

SignedHeaders = Lowercase(HeaderName0) + ';' + Lowercase(HeaderName1) + ";" + ... + Lowercase(HeaderNameN)

创建签名字符串
签名字符串主要包含请求以及正规化请求的元数据信息，由签名算法、请求日期、信任状和正规化请求哈希值连接组成，伪代码如下：

StringToSign = Algorithm + '\n' + RequestDate + '\n' + CredentialScope + '\n' + HexEncode(Hash(CanonicalRequest))

字段说明如下。

计算签名秘钥
1.计算签名前，首先从 Secret Access Key 派生出签名密钥（Signing Key），而不是直接使用 Secret Access Key。具体计算过程如下：

kSecret = *Your Secret Access Key*
 kDate = HMAC(kSecret, Date)
 kRegion = HMAC(kDate, Region)
 kService = HMAC(kRegion, Service)
 kSigning = HMAC(kService, "request")

2.计算签名。

Signature = HexEncode(HMAC(kSigning, StringToSign))

3.构建 Header。

Authorization: HMAC-SHA256 Credential={AccessKeyId}/{CredentialScope}, SignedHeaders={SignedHeaders}, Signature={Signature}

返回结果
调用火山引擎 OpenAPI 后，所有返回结果都会带上 RequestId、Action、Version、Service、Region 等字段。
正常返回示例
接口调用成功后，会返回请求 ID 和接口返回参数。HTTP 状态码为 2xx。

{
     "ResponseMetadata": {
         "RequestId": "2020102017223001022507", 
         "Action": "{Action}",
         "Version": "{Version}",
         "Service": "{Service}",
         "Region": "{Region}" 
     },
     "Result":"..."
 }

异常返回示例
接口调用出错后，会返回请求 ID 和错误信息。HTTP 状态码为 4xx 或者 5xx。
您可以根据接口错误代码 Code 和错误信息 Message，参考 公共错误码 和具体接口错误码排查错误。

{
     "ResponseMetadata": {
         "RequestId": "202010201722300102****",
         "Action": "{Action}",
         "Version": "{Version}",
         "Service": "{Service}",
         "Region": "{Region}",
         "Error": {
             "Code": "InvalidActionOrVersion",
             "Message": "Could not find operation GetUserById for version 2018-01-01"
         }
     }
 }