รับข้อมูลเมตาของเอกสาร

เรียกดูค่าข้อมูลเมตาของเอกสารแบบเป็นชุดด้วย ID เอกสาร และส่งคืน auto_metadata (ระบบกรอกให้อัตโนมัติและอ่านอย่างเดียว) กับ metadata (ค่าฟิลด์ที่กำหนดเอง) คำขอหนึ่งครั้งเรียกดูได้สูงสุด 50 เอกสาร

เมธอดคำขอ

GET

Endpoint

https://api-${endpoint}.gptbots.ai/v1/bot/doc/metadata/detail

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

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

คำขอ

ตัวอย่างคำขอ

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/bot/doc/metadata/detail?doc_ids=doc_001,doc_002' \ -H 'Authorization: Bearer ${API Key}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/bot/doc/metadata/detail?doc_ids=doc_001,doc_002' \
-H 'Authorization: Bearer ${API Key}'

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

ส่วนหัวคำขอ

ฟิลด์	ประเภท	คำอธิบาย
Authorization	Bearer ${API Key}	ยืนยันตัวตนด้วย `Authorization: Bearer ${API Key}` และรับ API Key ได้จากหน้าคีย์ API

พารามิเตอร์คำขอ

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
doc_ids	String	ใช่	ID เอกสารที่คั่นด้วยเครื่องหมายจุลภาค สูงสุด 50 รายการต่อคำขอ เอกสารทั้งหมดต้องเป็นของ Agent ที่เชื่อมโยงกับ API Key ปัจจุบัน หากมีเอกสารใดไม่มีอยู่หรือไม่ได้เป็นของ Agent ปัจจุบัน คำขอทั้งหมดจะล้มเหลวพร้อมข้อความ `one or more doc_ids do not exist or do not belong to the current bot`

การตอบกลับ

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

{ "documents": [ { "doc_id": "doc_001", "auto_metadata": { "document_name": "ข้อกำหนด API.pdf", "upload_time": "2026-01-15T10:30:00Z" }, "metadata": { "category": "เทคนิค", "priority": "P1" } } ] }

                      
                      {
    "documents": [
        {
            "doc_id": "doc_001",
            "auto_metadata": {
                "document_name": "ข้อกำหนด API.pdf",
                "upload_time": "2026-01-15T10:30:00Z"
            },
            "metadata": {
                "category": "เทคนิค",
                "priority": "P1"
            }
        }
    ]
}

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

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

ฟิลด์	ประเภท	คำอธิบาย
documents	Array<Object>	ข้อมูลเมตาของแต่ละเอกสาร เอกสารที่ไม่มีบันทึกข้อมูลเมตาจะไม่ถูกส่งกลับ
doc_id	String	ID เอกสาร
auto_metadata	Object	ข้อมูลเมตาที่ระบบกรอกโดยอัตโนมัติ (ชื่อเอกสาร/เวลาอัปโหลด/ผู้อัปโหลด/แหล่งที่มา ฯลฯ) อ่านอย่างเดียว
metadata	Object	ค่าข้อมูลเมตาที่กำหนดเอง รูปแบบคือ "ชื่อฟิลด์ → ค่า"

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

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