ข้ามไปที่เนื้อหา

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 String AppId ที่กำหนดไว้ใน Hive SDK
logBody Array อาร์เรย์บันทึก
logBody.catagory String หมวดหมู่ที่กำหนดในคำจำกัดความบันทึก
logBody.dateTime String เวลาบันทึกในรูปแบบ YYYY-MM-DD HH:mm:SS ใน KST หรือ ISO-8601
logBody.guid String ค่าคีย์แบบสุ่ม

ใส่ค่าทุกค่าในแถวที่เกี่ยวข้องของ 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 boolean false False จะถูกกำหนดไว้เว้นแต่รหัสสถานะ HTTP จะเป็น 200
message String ดูด้านล่าง ข้อความแสดงข้อผิดพลาด
requestBody String ค่าที่ร้องขอ บันทึกต้นทางที่ส่งไปยัง


  • รหัสข้อผิดพลาดในฟิลด์ข้อความมีดังนี้
ข้อความ คำอธิบาย
ไม่มี json body ไม่มีพารามิเตอร์
json parse error ข้อผิดพลาดในรูปแบบ JSON
json format error = required field {col} not found คอลัมน์ที่จำเป็น ({col}) ไม่มีอยู่
[logBody] json format error = required field {logBody.col} not found คอลัมน์ที่จำเป็น ({logBody.col}) ไม่มีอยู่ใน logBody
unknown category key : หมวดหมู่ที่ไม่รองรับถูกใช้งาน