添加消息通知联系人。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Name |
string |
是 |
联系人的名称。 联系人的名称在资源目录内必须唯一。 格式:2~12 个英文字母或汉字。 |
tom |
| EmailAddress |
string |
是 |
联系人的邮箱地址。 添加邮箱地址后,您需要继续调用 SendEmailVerificationForMessageContact 向该邮箱地址发送验证信息,通过验证后,该联系人的邮箱地址才能生效。 |
someone***@example.com |
| PhoneNumber |
string |
否 |
联系人的手机号码。 格式: 说明
仅支持填写 添加手机号码后,您需要继续调用 SendPhoneVerificationForMessageContact 向该手机号码发送验证信息,通过验证后,该联系人的手机号码才能生效。 |
86-139****1234 |
| Title |
string |
是 |
联系人的职位。 枚举值:
|
TechnicalDirector |
| MessageTypes |
array |
是 |
联系人接收的消息分类。 |
|
|
string |
否 |
联系人接收的消息分类。 枚举值:
|
AccountExpenses |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回结果。 |
||
| RequestId |
string |
请求 ID。 |
2DFCE4C9-04A9-4C83-BB14-FE791275EC53 |
| Contact |
object |
联系人信息。 |
|
| ContactId |
string |
联系人 ID。 |
c-qL4HqKONzOM7**** |
| CreateDate |
string |
联系人创建时间。 |
2023-03-27 17:19:21 |
示例
正常返回示例
JSON格式
{
"RequestId": "2DFCE4C9-04A9-4C83-BB14-FE791275EC53",
"Contact": {
"ContactId": "c-qL4HqKONzOM7****",
"CreateDate": "2023-03-27 17:19:21"
}
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | MissingParameter.Name | You must specify Name. | |
| 400 | InvalidParameter.Name | The Name is invalid. | |
| 400 | InvalidParameter.Name.Length | The Name exceeds the length limit. | |
| 400 | InvalidParameter.Name.AlreadyUsed | The Name already exists. Please change to another name. | |
| 400 | MissingParameter.EmailAddress | You must specify EmailAddress. | |
| 400 | InvalidParameter.EmailAddress | The EmailAddress is invalid. | |
| 400 | MissingParameter.PhoneNumber | You must specify PhoneNumber. | |
| 400 | InvalidParameter.PhoneNumber | The PhoneNumber is invalid. | |
| 400 | MissingParameter.Title | You must specify Title. | |
| 400 | InvalidParameter.Title | The Title is invalid. | |
| 400 | MissingParameter.MessageTypes | You must specify MessageTypes. | |
| 400 | InvalidParameter.MessageTypes | The MessageTypes is invalid. | |
| 400 | LimitExceeded.Contacts | The maximum number of contacts in a resource directory exceeds the limit. | |
| 400 | InvalidParameter.MobileCountryCode | The current site does not support the country code. | |
| 400 | InvalidParameter.EmailAddress.Length | The EmailAddress exceeds the length limit. | |
| 429 | ConcurrentCallNotSupported | The operation conflicts with other operations. Please try again later. |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。