อัปเดตข้อมูลในตาราง

อัปเดตข้อมูลในตาราง

API นี้ช่วยให้คุณสามารถอัปเดตข้อมูลในตารางฐานข้อมูลของ Agent ได้แบบเป็นชุด สูงสุด 100 รายการต่อคำขอ

หมายเหตุ

  • ขนาดของ request body (JSON ทั้งหมด) จำกัดที่ 5MB
  • แต่ละคำขอสามารถอัปเดตข้อมูลได้สูงสุด 100 รายการ

วิธีการร้องขอ

POST

URL สำหรับร้องขอ

https://api.${endpoint}gptbots.ai/v2/database/update/record

การยืนยันตัวตน

รายละเอียดการยืนยันตัวตน กรุณาดูที่ ภาพรวม API

ตัวอย่างการร้องขอ

curl -X POST 'https://api-${endpoint}gptbots.ai/v2/database/update/record' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "is_create": true, "update_data":[ { "record_id":"123456", "updated_fields": { "name": "andy", "age": "30" } }, { "filter": { "id": "789" }, "updated_fields": { "name": "mop", "age": "32" } } ] }'
                      
                      curl -X POST 'https://api-${endpoint}gptbots.ai/v2/database/update/record' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
      "table_id": "673af861ed69656ac0895b07",
      "is_create": true,
      "update_data":[
        {
          "record_id":"123456",
          "updated_fields": {
            "name": "andy",
            "age": "30"
          }
        },
        {
          "filter": {
            "id": "789"
          },
          "updated_fields": {
            "name": "mop",
            "age": "32"
          }
        }
      ]
    }'

                    
บล็อกโค้ดนี้ในหน้าต่างลอย

ส่วนหัวของคำร้องขอ

ฟิลด์ ประเภท คำอธิบาย
Authorization Bearer ${API Key} การยืนยันตัวตนโดยใช้ Authorization: Bearer ${API Key} รับ API Key ได้ที่หน้า API Keys
Content-Type application/json รูปแบบข้อมูล ต้องเป็น application/json

เนื้อหาคำร้องขอ

ฟิลด์ ประเภท จำเป็น คำอธิบาย
table_id string ใช่ รหัสตาราง
is_create bool ไม่จำเป็น สร้างข้อมูลใหม่เมื่อ ไม่มีข้อมูลเป้าหมายที่ระบุ ในตารางหรือไม่
update_data list ใช่ กลุ่มข้อมูลที่จะอัปเดต
record_id string ไม่จำเป็น ต้องระบุ record_id หรือ filter อย่างใดอย่างหนึ่ง แนะนำให้ใช้ record_id
filter map ไม่จำเป็น เงื่อนไขการกรองที่ผู้ใช้กำหนด ต้องมีฟิลด์ที่ "unique": true และรองรับได้เพียง 1 ฟิลด์
updated_fields list ใช่ กลุ่มฟิลด์ที่ต้องการอัปเดต

หมายเหตุ

  • ต้องระบุ record_id หรือ filter อย่างใดอย่างหนึ่ง หากส่งทั้งสอง record_id จะมีลำดับความสำคัญกว่า
  • ค่าเริ่มต้นของ is_create คือ false
  • หากไม่ระบุ is_create จะไม่มีการสร้างข้อมูลใหม่โดยอัตโนมัติ
  • หากตั้งค่า is_create เป็น true และไม่มี record_id หรือ filter ที่ต้องการอัปเดตในตาราง ระบบจะสร้างข้อมูลให้อัตโนมัติ

การตอบกลับ

ตัวอย่างการตอบกลับ

{ "totalCount": 4, "success_count": 2, "fail_count": 2, "fail_detail": [ { "upsert_data": { "record_id": "123456", "value": { "name": "test user", "email": "invalid_email" } }, "fail_reason": "รูปแบบอีเมลไม่ถูกต้อง" }, { "upsert_data": { "filter": { "id": "789" }, "value": { "name": "test user", "email": "invalid_email" } }, "fail_reason": "รูปแบบอีเมลไม่ถูกต้อง" } ] }
                      
                      {
    "totalCount": 4,
    "success_count": 2,
    "fail_count": 2,
    "fail_detail": [
        {
            "upsert_data": {
                "record_id": "123456",
                "value": {
                    "name": "test user",
                    "email": "invalid_email"
                }
            },
            "fail_reason": "รูปแบบอีเมลไม่ถูกต้อง"
        },
        {
            "upsert_data": {
                "filter": {
                    "id": "789"
                },
                "value": {
                    "name": "test user",
                    "email": "invalid_email"
                }
            },
            "fail_reason": "รูปแบบอีเมลไม่ถูกต้อง"
        }
    ]
}

                    
บล็อกโค้ดนี้ในหน้าต่างลอย

การตอบกลับเมื่อสำเร็จ

ฟิลด์ ประเภท คำอธิบาย
totalCount int จำนวนข้อมูลทั้งหมดที่อัปเดตในคำขอนี้
success_count string จำนวนข้อมูลที่อัปเดตสำเร็จ
fail_count string จำนวนข้อมูลที่อัปเดตไม่สำเร็จ
fail_detail array รายละเอียดข้อมูลที่อัปเดตไม่สำเร็จ
upsert_data array ข้อมูลที่ร้องขอสำหรับการอัปเดตที่ล้มเหลวนี้
fail_reason array เหตุผลที่อัปเดตไม่สำเร็จ

การตอบกลับเมื่อเกิดข้อผิดพลาด

ฟิลด์ ประเภท คำอธิบาย
code int รหัสข้อผิดพลาด
message string รายละเอียดข้อความข้อผิดพลาด

รหัสข้อผิดพลาด

รหัส ข้อความ
40000 พารามิเตอร์ไม่ถูกต้อง
50000 ข้อผิดพลาดภายในระบบ
403106 ไม่พบตารางข้อมูล
403131 ไม่มีสิทธิ์เข้าถึงตาราง