跳转至

HTTP

HTTP


  • 标题信息

  • 方法：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 中必需列 ({logBody.col}) 不存在
未知类别键 : 使用了不支持的类别