我们将弃用本地 API。请参阅我们的本地 API 弃用文档,了解弃用详情以及如何迁移到我们的下一代云端 API。

Webhooks 认证机构证书

如果您在应用程序设置中配置的 Webhooks 网址使用内部认证机构 CA 证书,请使用此端点管理您的证书。

检索

使用此端点来检索您的 Webhooks CA 证书。

示例

请求:

GET /v1/certificates/webhooks/ca

响应:

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

certificate

如果未找到证书,则系统会返回没有正文的 404 响应代码。

上传

如果应用程序设置中配置的 Webhooks 网址使用内部 CA 证书,则您需要将该 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 {}