อัปเดตข้อมูลตาราง
อัปเดตข้อมูลตาราง
อินเทอร์เฟซนี้ช่วยให้คุณอัปเดตค่าข้อมูลเฉพาะในตารางข้อมูล Agent ได้
วิธีการร้องขอ
POST
Endpoint
https://api-${endpoint}.gptbots.ai/v1/database/update/record
การยืนยันตัวตน
ดูรายละเอียดวิธีการยืนยันตัวตนได้ที่ API Overview
ตัวอย่างการร้องขอ
curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/update/record' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
"table_id": "673af861ed69656ac0895b07",
"record_id": "123456",
"filter": {
"id": "789"
},
"updated_fields": {
"name": "99990",
"age": "30"
}
}'
curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/update/record' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
"table_id": "673af861ed69656ac0895b07",
"record_id": "123456",
"filter": {
"id": "789"
},
"updated_fields": {
"name": "99990",
"age": "30"
}
}'
บล็อกโค้ดนี้ในหน้าต่างลอย
Request Headers
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| Authorization | Bearer ${API Key} | ใช้ Authorization: Bearer ${API Key} สำหรับการยืนยันตัวตน รับ API Key ได้จากหน้า API Key |
| Content-Type | application/json | ประเภทข้อมูล ให้ใช้ค่า application/json |
Request Body
| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
| table_id | string | ใช่ | รหัสตารางข้อมูล |
| record_id | string | ไม่จำเป็น | รหัสข้อมูล หรือใช้ filter อย่างใดอย่างหนึ่ง (แนะนำให้ใช้รหัสข้อมูล) |
| filter | map | ไม่จำเป็น | เงื่อนไข filter แบบกำหนดเอง (ต้องใช้ฟิลด์ Primary Key ที่ไม่ซ้ำกัน) |
| updated_fields | list | ใช่ | ข้อมูลที่ต้องการอัปเดต |
| is_add | boolean | ไม่จำเป็น | เพิ่มข้อมูลใหม่หากไม่พบข้อมูลเดิมหรือไม่ |
การตอบกลับ
ตัวอย่างการตอบกลับ
{
"code": 0,
"message": "OK"
}
{
"code": 0,
"message": "OK"
}
บล็อกโค้ดนี้ในหน้าต่างลอย
การตอบกลับเมื่อสำเร็จ
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| code | int | รหัสผลลัพธ์ |
| message | string | ข้อความอธิบาย |
| data | object | ข้อมูลตอบกลับ รวมถึงรหัสเฉพาะของตารางข้อมูล |
การตอบกลับเมื่อผิดพลาด
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| code | int | รหัสข้อผิดพลาด |
| message | string | รายละเอียดข้อผิดพลาด |
รหัสข้อผิดพลาด
| รหัส | ข้อความ |
|---|---|
| 40000 | พารามิเตอร์ไม่ถูกต้อง |
| 50000 | ข้อผิดพลาดภายในระบบ |
| 403106 | ไม่พบตารางข้อมูล |
| 403131 | ไม่มีสิทธิ์เข้าถึงตารางข้อมูล |