WhatsApp Business Platform > On-Premises API > Reference

账户

/v1/account

我们将弃用 On-Premises API。此端点无法再用于注册公司电话号码，且现在将返回以下错误：

{
  "code": 1005,
  "title": "Access denied",
  "details": "Unknown error: biz_link_on_prem_reg_blocked"
}

account 节点用于注册 WhatsApp Business API 客户端。

请注意，如果集群上已注册一个号码，再注册新号码时，核心应用将重启。

连线

以下连线会连接至此节点：

连线	描述
`/verify`	在您通过指定方式收到注册码后，请使用此连线完成您的帐户注册。

前期准备

您需要提供：

可用于登录服务的身份验证口令
与 WhatsApp Business 商业帐号关联的有效电话号码
与该电话号码关联的 WhatsApp 获准显示名

复制以 Base64 方式编码的证书

在 WhatsApp Business API 客户端注册期间，系统会为您生成以 Base64 方式编码的证书字符串，以供验证时使用。

前往 Meta 商务管理平台中的业务设置。
如果您的 WhatsApp 帐号尚未高亮显示，请点击帐号菜单下的 WhatsApp 帐号，然后从 WhatsApp 帐号列表中选择该帐号。
前往设置选项卡，然后点击 WhatsApp 管理工具按钮。
电话号码选项卡下应当会列出您的电话号码。在您想为其获取证书的电话号码所在栏中点击查看按钮。
获取证书
弹出对话框的灰色框中会显示证书字符串。点击获取证书。
下载证书字符串
使用 account 端点进行注册时，在 cert 参数中使用此证书字符串。

如需更多信息，请参阅显示名文档。

限制

您必须使用 admin 帐号来注册应用程序。
如果您正在重新注册帐号，则需在完成注册后重启核心应用。

请求

向此终端发起 POST 通话，以请求注册代码。在调用过程中，添加您的手机号码和以 Base64 方式编码的证书字符串。您可以通过短信或语音通话来接收代码。

示例

POST /v1/account

{
    "cc": "COUNTRY_CODE",
    "phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
    "method": "sms" or "voice",
    "cert": "VERIFIED_NAME_CERT_IN_BASE64",
    "pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}

根据收到的响应，我们可以认为注册程序已完成，或需要其他步骤来完成。如果注册成功，您会收到下列 HTTP 状态代码中的一个。请根据您收到的响应执行相应操作：

201 Created — 该帐户已经存在。您已经注册过应用，因此无需进行其他操作。
202 Accepted — 该帐户不存在。请根据您在请求中选择的方式，检查用于接收注册代码的短信或语音通话号码。此响应将包括一个返回的负载，其中包含从 cert 参数解码的 vname，供您确认要设置的显示名称正确无误。如果正确，请继续在完成您的帐户注册部分来完成注册。

{
  "account": [{
      "vname": "decoded-vname-from-cert"
  }]
}

如果返回任何错误，请参阅错误和状态消息，以获取更多信息。

参数

名称	描述
`cc`	必要。您所要注册电话号码的国家/地区数字代码
`phone_number`	必要。您所要注册的电话号码，请勿带有国家/地区代码或加号 (`+`)。
`method`	必要。注册代码的接收方式选项：`voice`、`sms`
`cert`	必要。以 Base64 方式编码的证书。
`pin`	非必要。现有的 6 位 PIN 码，仅在此帐号启用双重验证时为必需项。