PublishService.VerifyPlatformAccount

验证平台账号凭证

验证平台账号凭证是否有效，可在正式绑定或发布前检查凭证可用性。

Authentication

支持组合	OAuth 2.0	API Key
No identity
User identity
Org identity

所需 scopes：creative:write

Request body · VerifyPlatformAccountRequest

字段	类型	必填	描述
`platform`	`Platform`	—	目标平台。
`credentials`	`object`	—	平台凭证，键值对格式。微信公众号: {"appid": "...", "appsecret": "..."}

Response

200 OK · VerifyPlatformAccountResponse

字段	类型	必填	描述
`valid`	`boolean`	—	凭证是否有效。
`display_name`	`string`	—	验证通过时返回的账号名称（如公众号名称）。
`error_message`	`string`	—	验证失败时的错误信息。

错误响应 · google.rpc.Status

非 2xx 响应均按 AIP-193 规范包装为google.rpc.Status，含 code /message /details 三段。details[].reason 是机器可读的具体错误原因码，可用于客户端分支处理。

字段	类型	必填	描述
`code`	`integer (int32)`	—	The status code, which should be an enum value of google.rpc.Code.
`message`	`string`	—	A developer-facing error message.
`details`	`array<Any>`	—	A list of messages that carry the error details.

Examples

curl -X POST \
  'https://api.appforges.com/v1/creative/platform-accounts/verify' \
  -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "platform": "PLATFORM_UNSPECIFIED",
    "credentials": {}
  }'

OpenAPI spec v0.59.4 · synced 10/11/2026, 11:27:14 PM