HTTP

HTTP¶

伺服器資訊 分析日誌網頁伺服器 URL 如下。
沙盒伺服器 : https://sandbox-analytics-log.withhive.com/v1/server-recv
通用伺服器 : https://analytics-log.withhive.com/v1/server-recv

標題資訊
方法: POST
內容類型 : application/json; charset=utf8 (必填)
內容編碼 : gzip (可選項，用於在主體中放置壓縮的二進位檔)

# 使用壓縮二進位檔的範例
{
      "appId" : "com.com2us.hivesdk.freefull.google.global.android.common",
      "logBody" : [
      {
              "category" : "test",
              "dateTime" : "2017-07-24 16:46:36",
              "timezone" : "GMT+09:00",
              "guid" : "xxxx"
      },
      {
              "category" : "test2",
              "dateTime" : "2017-07-24 16:46:36",
              "timezone" : "GMT+09:00",
              "guid" : "xxxx2"
      }
      ]
}

身體資訊
JSON 類型。請按照以下提到的格式發送數據。某些字段需要指定的鍵值。
必要參數（需要從日誌中發送以下字段）


appId	字串	在 Hive SDK 上指定的 AppId
logBody	陣列	日誌陣列
logBody.catagory	字串	在日誌定義中指定的類別
logBody.dateTime	字串	KST 中的 YYYY-MM-DD HH:mm:SS 格式的日誌時間，或 ISO-8601
logBody.guid	字串	隨機鍵值

按照日志将每个值放入logBody的相关行中。

範例¶

呼叫¶

curl -d " { \"appId\" : \"com.com2us.hivesdk.freefull.google.global.android.common\", \"logBody\" : [ { \"category\" : \"hivesdk_levelup_log\", \"dateTime\" : \"2017-07-24 16:46:36\", \"timezone\" : \"GMT+09:00\", \"guid\" : \"xxxx\" } ] }"  -X POST https://sandbox-analytics-log.withhive.com/v1/server-recv

請求¶

> POST /v1/server-recv HTTP/1.1
> Host: sandbox-analytics-log.withhive.com
> User-Agent: curl/7.55.1
> Accept: */*
> Content-Length: 208
> Content-Type: application/x-www-form-urlencoded
>
{
    "appId" : "com.com2us.hivesdk.freefull.google.global.android.common",
    "logBody" : [
    {
            "category" : "test",
            "dateTime" : "2017-07-24 16:46:36",
            "timezone" : "GMT+09:00",
            "guid" : "xxxx"
    }
    ]
}

回應¶

< HTTP/1.1 200 OK
< Server: nginx
< Date: Tue, 12 Nov 2019 09:36:55 GMT
< Content-Type: text/html; charset=UTF-8
< Transfer-Encoding: chunked
< Connection: close
< {"success":true}

如果HTTP響應狀態碼為200，則發送日誌成功。除非它失敗。

鍵	類型	值	描述
success	布林值	false	除非 HTTP 狀態碼為 200，否則為固定的 false
message	字串	見下文	錯誤訊息
requestBody	字串	請求值	傳輸的原始日誌

訊息欄中的錯誤代碼如下。

訊息	描述
無 JSON 主體	無參數
JSON 解析錯誤	JSON 格式錯誤
JSON 格式錯誤 = 必填欄位 {col} 未找到	必要欄位 ({col}) 不存在
[logBody] JSON 格式錯誤 = 必填欄位 {logBody.col} 未找到	必要欄位 ({logBody.col}) 在 logBody 中不存在
未知類別鍵 :	使用了不支援的類別