Bên ngoài

/v1/certificates/external

Sử dụng cạnh này để tải lên, truy xuất, xóa và đặt lại Chứng chỉ của Cơ quan chứng thực (CA).

Trước khi bạn bắt đầu

Bạn phải sử dụng tài khoản admin để tải lên và xóa tất cả chứng chỉ.

Truy xuất

Thực hiện lệnh gọi GET đến điểm cuối này để truy xuất chứng chỉ CA được lưu trữ trong ứng dụng API WhatsApp Business.

Ví dụ

Yêu cầu:

GET /v1/certificates/external/ca

Phản hồi:

Content-Type: text/plain
Content-Length: content-size

certificate

Nếu không tìm thấy chứng chỉ CA, hệ thống sẽ trả về mã phản hồi 404 mà không có nội dung.

Tải lên

Thực hiện lệnh gọi POST để tải chứng chỉ CA lên. Đảm bảo rằng chứng chỉ tải lên có chứa các phần sau đây trong một file và theo thứ tự như bên dưới:

1. Khóa riêng tư
2. Chứng chỉ
3. Một hoặc nhiều chứng chỉ CA trung gian - Ứng dụng API WhatsApp Business cần có ít nhất một chứng chỉ CA trung gian. Nếu không, quá trình tải lên sẽ không thành công.

Ví dụ

Để tải chứng chỉ lên ứng dụng API WhatsApp Business, hãy sử dụng yêu cầu API sau đây (có Content-Type là text/plain).

POST /v1/certificates/external
  Content-Type: text/plain
  Content-Length: content-size

certificate

Nếu dùng cURL, lệnh sẽ có dạng như sau:

curl -X POST \
  https://your-webapp-hostname:your-webapp-port/v1/certificates/external \
  -H 'Authorization: Bearer your-auth-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @your-path-to-certificate.pem 

Nếu đã tồn tại một chứng chỉ, chứng chỉ đó sẽ bị ghi đè. Sau khi tải chứng chỉ lên, bạn phải khởi động lại máy chủ web, tức là tất cả phiên bản vùng chứa Webapp.

Bạn phải thật cẩn trọng để chỉ cập nhật chứng chỉ bằng chứng chỉ hợp lệ (tức là đúng và chính xác). Nếu không, máy chủ web sẽ không khởi động lại được (vì điểm cuối API bị lỗi) và bạn phải xử lý thủ công để khắc phục tình trạng này.

Phản hồi cho lệnh gọi API có dạng như sau:

null

Đặt lại

Khi tải chứng chỉ CA lên ứng dụng API WhatsApp Business, nếu chứng chỉ không hợp lệ vì lý do nào đó, vùng chứa Webapp sẽ không khởi động lại được vì điểm cuối API sẽ bị lỗi. Để khắc phục tình trạng này, bạn cần xóa bảng cơ sở dữ liệu certs.

Cách xóa bảng cơ sở dữ liệu certs:

1. Dừng vùng chứa Webapp:
   

   docker stop your-webapp-container-id

2. Kết nối với MySQL qua Docker trong dòng lệnh:

   docker exec -it your-mysql-container-id mysql -uroot -p

3. Nhập mật khẩu MySQL khi được nhắc (theo mysql.conf).
4. Kiểm tra xem đã có bảng certs hay chưa:

   show tables in waweb;

5. Xóa bảng certs:

   drop table waweb.certs;

6. Thoát MySQL:

   exit;

7. Khởi động lại vùng chứa Webapp:

   docker restart your-webapp-container-id

8. Đăng nhập lại vào MySQL theo các bước ở trên để đảm bảo rằng bảng certs hiện đã tồn tại.

Xóa

Chưa hỗ trợ xóa chứng chỉ. Trong tương lai, chúng tôi có thể hỗ trợ tính năng này nếu cần xem xét một trường hợp sử dụng.