本文列舉了日志服務API的公共請求頭信息。
參數列表
日志服務API是基于HTTP協議的REST風格接口。它支持一組可以在所有API請求中使用的公共請求頭，其詳細說明如下：
| Header名稱 | 類型 | 是否必須 | 說明 |
| Accept | 字符串 | 否 | 客戶端希望服務端返回的類型，目前支持application/json、application/x-protobuf兩種。僅對GET請求有效，具體取值以各個接口定義為準。 |
| Accept-Encoding | 字符串 | 否 | 客戶端希望服務端返回的壓縮算法，目前支持lz4、deflate或空（不壓縮）。僅對GET類請求有效，具體取值以各個接口定義為準。 |
| Authorization | 字符串 | 是 | 簽名內容，更多細節請參考 請求簽名。 |
| Content-Length | 數值 | 否 | RFC 2616中定義的HTTP請求Body長度。如果請求無Body部分，則不需要提供該請求頭。 |
| Content-MD5 | 字符串 | 否 | 請求Body經過MD5計算后的字符串，計算結果為大寫。如果沒有Body部分，則不需要提供該請求頭。 |
| Content-Type | 字符串 | 否 | RFC 2616中定義的HTTP請求Body類型。目前日志服務API請求只支持application/x-protobuf類型。如果沒有Body部分，則不需要提供該請求頭。具體取值以各個接口定義為準。 |
| Date | 字符串 | 是 | 當前發送時刻的時間，參數目前只支持RFC 1123格式，使用GMT標準時間。格式化字符串如下：%a,%d%b%Y %H:%M:%S GMT （例如：Mon, 3 Jan 2010 08:33:47 GMT）。 |
| Host | 字符串 | 是 | HTTP請求的完整HOST名稱（不包括如http://這樣的協議頭）。例如，big-game.cn-hangzhou.sls.aliyuncs.com。 |
| x-log-apiversion | 字符串 | 是 | API的版本號，當前版本為0.6.0。 |
| x-log-bodyrawsize | 數值 | 否 | 請求的Body原始大小。當無Body時，該字段為0；當Body是壓縮數據，則為壓縮前的原始數據大小。該域取值范圍為0~3x1024x1024。該字段只在壓縮時需要。 |
| x-log-compresstype | 字符串 | 否 | API請求中Body部分使用的壓縮方式。目前支持lz4壓縮類型和deflate壓縮類型（RFC 1951，使用zlib格式，參考RFC 1950）。如果不壓縮可以不提供該請求頭。 |
| x-log-date | 字符串 | 否 | 當前發送時刻的時間，格式和Date頭一致。如果請求中包含該公共請求頭，它的值會取代Date標準頭的值用于服務端請求驗證（該字段不參與簽名）。無論是否有x-log-date頭，HTTP標準Date頭都必須提供。 |
| x-log-signaturemethod | 字符串 | 是 | 簽名計算方式，目前僅支持hmac-sha1。 |
| x-acs-security-token | 字符串 | 否 | 使用STS臨時身份發送數據。當使用STS臨時身份時必填，其他情況不要填寫。 |
說明
- 請求中Date所表示的時間與服務器接收到該請求的時間最大可接受誤差為15分鐘，如果超過15分鐘服務器端會拒絕該請求。如果請求中設置了x-log-date頭部，則該時間誤差計算基于x-log-date頭的值。
- 如果請求指明了壓縮算法（在x-log-compresstype中指定），則需要把原始數據壓縮后放到HTTP Body部分，而對應的Content-Length、Content-MD5頭部也是按照壓縮后的Body部分計算。
- 由于某些平臺發送HTTP請求時無法指定Date頭（由平臺自身的庫內部自動指定為發送當前時間），造成無法使用正確的Date值計算請求簽名。在這種情況下，請指定x-log-date頭并用該請求頭的值參與請求簽名計算。日志服務端在接收到API請求后會首先判斷是否有x-log-date頭。如果有，則用它的值來做簽名驗證，否則就用HTTP的標準頭Date做簽名驗證。
示例
POST / HTTP/1.1
Authorization: LOG <yourAccessKeyId>:<yourSignature>
x-log-bodyrawsize: 0
User-Agent: sls-java-sdk-v-0.6.1
x-log-apiversion: 0.6.0
Host: my-project-test.cn-shanghai.log.aliyuncs.com
x-log-signaturemethod: hmac-sha1
Date: Sun, 27 May 2018 07:43:26 GMT
Content-Type: application/json
Content-MD5: A7967D81EFF5E3CD447FB6D8DF294E20
Content-Length: 80
Connection: Keep-Alive文檔內容是否對您有幫助？