ลบข้อมูลในตาราง

ลบข้อมูลในตาราง

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

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

POST

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

https://api-${endpoint}/v2/database/delete/record

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

ดูรายละเอียดวิธีการยืนยันตัวตนได้ที่หัวข้อ Authentication ใน API Overview

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

curl -X POST 'https://api-${endpoint}/v2/database/delete/record' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "delete_data":[ { "record_id":"123456" }, { "filter": { "id": "789" } } ] }'
                      
                      curl -X POST 'https://api-${endpoint}/v2/database/delete/record' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
      "table_id": "673af861ed69656ac0895b07",
      "delete_data":[
        {
          "record_id":"123456"
        },
        {  
          "filter": {
            "id": "789"
          }
        }
      ]
    }'

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

Request Headers

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

Request Body

ฟิลด์ ประเภท จำเป็น คำอธิบาย
table_id string ใช่ รหัสของตาราง
delete_data array ใช่ อาร์เรย์ของข้อมูลที่ต้องการลบ
record_id string ไม่จำเป็น เลือกใช้ record_id หรือ filter ก็ได้ แนะนำให้ใช้ record_id
filter map ไม่จำเป็น เงื่อนไขการกรองแบบกำหนดเอง (ต้องใช้ฟิลด์ primary key ที่ไม่ซ้ำกัน)

หมายเหตุ: ต้องระบุอย่างใดอย่างหนึ่งระหว่าง record_id หรือ filter โดยแนะนำให้ใช้ record_id หากระบุทั้งสองอย่าง จะใช้ record_id เป็นหลัก

การตอบกลับ

ตัวอย่าง Response

{ "code": 0, "message": "OK" }
                      
                      {
    "code": 0,
    "message": "OK"
}

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

Response เมื่อสำเร็จ

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

Response เมื่อเกิดข้อผิดพลาด

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

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

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