我們即將停用內部部署 API。詳情請參閱內部部署 API 停用文件,並從中了解如何轉用新一代雲端 API。

Webhooks 認證機構證書

如果您在應用程式設定中配置的 Webhook 網址使用內部認證機構(CA)證書,請使用此端點管理您的證書。

檢索

使用此端點來檢索您的 Webhook CA 證書。

範例

要求:

GET /v1/certificates/webhooks/ca

回應:

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

certificate

如果找不到相應證書,則系統會傳回沒有正文的 404 回應代碼。

上載

如果您在應用程式設定中配置 Webhook 網址時使用內部 CA 證書,則您需要將此網址上載至 WhatsApp Business API 用戶端,以確保 WhatsApp Business API 支援此網址。如果您使用外部的已知 CA 證書,則您可以放心略過此部分。

您可以透過運行以下內容,產生 PEM 格式的自我簽署證書:

openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem

證書檔案需要採用 PEM 格式。如有多個證書需要上載,請首先將這些證書串聯為單個檔案:

cat cert1.pem cert2.pem > bundle.pem

範例

要求:

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

certificate

如要透過 cURL 傳送證書,應如下所示:

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

如果證書已存在,系統便會覆寫舊證書。上載證書後,您必須重新啟動所有核心應用程式節點,變更方會生效。

回應如下所示:

null or {}

刪除

向此端點傳送 DELETE 要求,以刪除您的 CA 證書。

範例

要求:

DELETE /v1/certificates/webhooks/ca

回應:

null or {}