ID สื่อ

/v1/media/{media-id}

จาก ID ที่เฉพาะเจาะจง ให้ใช้ตำแหน่งข้อมูลนี้เพื่อเรียกดูหรือลบสื่อของคุณ

ก่อนเริ่มต้น

ก่อนเรียกดูหรือลบ คุณต้องอัพโหลดสื่อผ่าน /v1/media ก่อน

การเรียกดู

หลังจากอัพโหลดสื่อสำเร็จแล้ว ให้คุณเรียกดูการตอบกลับที่มี ID สื่ออยู่ ใช้ ID ในคำขอใดๆ เพื่อเรียกดูสื่อนั้นๆ ที่จัดเก็บในไคลเอ็นต์ WhatsApp Business API

กระบวนการเรียกดูสื่อนี้ยังใช้เมื่อผู้ใช้ส่งรูปภาพให้แก่คุณโดยที่รับผ่าน Webhook เมื่อได้รับข้อความที่มีสื่อ ไคลเอ็นต์ WhatsApp Business API จะดาวน์โหลดสื่อนั้น เมื่อดาวน์โหลดสื่อแล้ว คุณจะได้รับการแจ้งเตือนผ่าน Webhook ของคุณ ให้ใช้ ID สื่อที่พบในการแจ้งเตือนนั้นเพื่อรับสื่อ

คุณสามารถเปิดใช้งานไคลเอ็นต์ WhatsApp Business API เพื่อดาวน์โหลดสื่อโดยอัตโนมัติด้วยการตั้งค่าการดาวน์โหลดสื่อโดยอัตโนมัติ

ตัวอย่าง

GET /v1/media/media-id

ตัวอย่างเช่น ใช้รูปภาพตัวอย่างที่อัพโหลดในส่วนก่อนหน้านี้

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' 

ในการส่งสื่อตัวอย่างนี้ไปยังไฟล์ ให้ใช้พารามิเตอร์ -o ตามที่แสดงด้านล่าง:

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' \
  -o path/filename

หากการเรียกสำเร็จ คุณจะเห็นการตอบกลับที่มีสถานะเป็น 200 OK และมีข้อมูลสื่อแบบไบนารี

Content-Type: image/jpeg or other appropriate media type
Content-Length: content-size

binary-media-data

หากคุณใช้เครื่องมือ เช่น Postman คุณจะเห็นรูปภาพนี้ หากคุณใช้เครื่องมือบรรทัดคำสั่ง คุณจะเห็นข้อมูลแบบไบนารี หากคุณส่งข้อมูลไปยังไฟล์ คุณจะเห็นรูปภาพในเบราว์เซอร์ไฟล์ของคุณ

หากไม่พบสื่อ ระบบจะส่งคืนรหัสการตอบกลับ 404 Not Found โดยไม่มีเนื้อความ

หากคุณได้รับข้อความแสดงข้อผิดพลาดอื่น โปรดดูข้อมูลเพิ่มเติมในข้อความแสดงข้อผิดพลาดและสถานะ

การลบ

หากต้องการลบสื่อในไคลเอ็นต์ WhatsApp Business ให้ส่งคำขอ DELETE ไปยังโหนด media พร้อม ID ของสื่อที่คุณต้องการลบ ใช้ ID ที่ตอบกลับมาเมื่ออัพโหลดสื่อหรือ ID จากข้อความสื่อจาก Webhook

ตัวอย่าง

คำขอ

DELETE /v1/media/media-id

การตอบกลับที่สำเร็จจะแสดงข้อความว่า 200 OK และมีเนื้อความแบบ null หรือ {} หากไม่พบสื่อ การตอบกลับจะแสดงข้อความว่า 404 Not Found และไม่มีเนื้อความอยู่ หากคุณได้รับข้อความแสดงข้อผิดพลาดอื่น โปรดดูข้อมูลเพิ่มเติมในข้อความแสดงข้อผิดพลาดและสถานะ