อัปเดตข้อมูลในตาราง
อัปเดตข้อมูลในตาราง
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 | ไม่มีสิทธิ์เข้าถึงตาราง |
