Nhà cung cấp phương tiện

/v1/settings/application/media/providers

Sử dụng điểm cuối /v1/settings/application/media/providers để biên soạn một danh sách các nhà cung cấp phương tiện nhằm gửi liên kết phương tiện.

Với danh sách nhà cung cấp, bạn có thể có các nhà cung cấp phương tiện khác nhau cho cùng loại nhà cung cấp, đồng thời có thể chọn một nhà cung cấp để sử dụng theo mỗi yêu cầu.

Tài liệu này bao gồm các nội dung sau:

• Cập nhật danh sách nhà cung cấp
• Truy xuất danh sách nhà cung cấp
• Xóa danh sách nhà cung cấp

Cập nhật danh sách nhà cung cấp

Để cấu hình các nhà cung cấp cho Ứng dụng WhatsApp Business API, hãy sử dụng điểm cuối /v1/settings/application/media/providers cùng với thông tin của nhà cung cấp. Hiện tại, bạn chỉ có thể thiết lập một nhà cung cấp mỗi lần. Đồng thời, hiện tại, bạn chỉ có thể sử dụng các đối tượng nhà cung cấp này để gửi tin nhắn đa phương tiện bằng các liên kết HTTP/HTTPS dựa trên hình thức xác thực cơ bản hoặc xác thực mã truyền tải.

Yêu cầu

Các ví dụ bên dưới minh họa quy trình thêm một nhà cung cấp WWW (tức là liên kết HTTP/HTTPS) bằng hình thức ủy quyền cơ bản và thêm một nhà cung cấp bằng hình thức xác thực mã truyền tải. Hiện tại, đây là những định dạng nhà cung cấp duy nhất được hỗ trợ.

POST /v1/settings/application/media/providers
[{
    "name": "your-first-provider",
    "type": "www",
    "config": {
        "basic": {
            "username": "your-username",
            "password": "your-password"
        }
    }
 }
]

POST /v1/settings/application/media/providers
[{
    "name": "your-second-provider",
    "type": "www",
    "config": {
        "bearer": "your-bearer-token"
    }
 }
]

Lưu ý: Hãy nhớ đặt tên duy nhất cho từng nhà cung cấp bởi vì việc dùng lại tên sẽ ghi đè mục nhập trước đó.

Thông số

Phản hồi

Một yêu cầu thành công sẽ trả về Mã trạng thái HTTP 200 OK và null hoặc {}.

Phản hồi không thành công sẽ chứa thông báo lỗi. Hãy xem phần Mã lỗi và mã trạng thái để biết thêm thông tin về lỗi.

Truy xuất danh sách nhà cung cấp

Yêu cầu

GET /v1/settings/application/media/providers

Phản hồi

Phản hồi thành công bao gồm danh sách nhà cung cấp.

"settings": {
        "application": {
            "media": {
                "providers": [ 
                    {
                        "name": "your-first-provider",
                        "type": "www",
                        "config": {
                            "basic": {
                                "username": "your-username",
                                "password": "your-password"
                            }
                        }
                    },
                    {
                        "name": "your-second-provider",
                        "type": "www",
                        "config": {
                            "bearer": "your-bearer-token"
                        }
                    }
                ]
            }
        }
    }

Phản hồi không thành công sẽ chứa thông báo lỗi. Hãy xem phần Mã lỗi và mã trạng thái để biết thêm thông tin về lỗi.

Xóa danh sách nhà cung cấp

Việc gửi lệnh gọi API DELETE cùng với name của nhà cung cấp tới điểm cuối /v1/settings/application/media/providers sẽ xóa nhà cung cấp đó khỏi danh sách nhà cung cấp.

Yêu cầu

DELETE /v1/settings/application/media/providers/your-config-name

Phản hồi

Một yêu cầu thành công sẽ trả về Mã trạng thái HTTP 200 OK và null hoặc {}.

Phản hồi không thành công sẽ chứa thông báo lỗi. Hãy xem phần Mã lỗi và mã trạng thái để biết thêm thông tin về lỗi.