如果您是注册用户,可以通过API来验证邮件地址的有效性。使用它非常简单,下面是API V2.0 开发文档:
URL
https://www.emailcamel.com/api/batch/validate
HTTP请求方式
POST
POST参数说明
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
usr | string | 是 | 用户名/注册邮箱 |
pwd | string | 是 | 注册密码 |
emailaddresslist | string | 是 | 邮件地址列表,多个用逗号分隔如:(每次请求<=5个邮箱)
yoel0x@gmail.com,oesphax@gmail.com,tlwaegex@gmail.com |
返回值说明
参数 | 值 | 说明 |
---|---|---|
verify_status | fail,success | 验证状态:成功返回success,失败返回fail |
fail_code | 100,101,102 | 100:身份认证错误 101:emailaddresslist参数问题,比如空或者单个请求大于5个 102:会员可用的验证次数不足 |
fail_msg | the username is not exist the username cannot be empty! the password cannot be empty! the username {$usr} has not been activated or is blocked username or password error! the email address list cannot be empty! the email address list can't exceed 5! the available validation times is not enough |
验证状态失败时可以依据此信息,查找原因 |
verify_emailaddresslist_result | 邮件地址验证结果
array( array( 'address'=>'test@domain1.com', 'result'=>''//valid,invalid,notverified,catch-all,dea,format_err,overfrequency ), array( 'address'=>'test@domain2.com', 'result'=>''//valid,invalid,notverified,catch-all,dea,format_err,overfrequency ), //... ) |
|
total_validate_num | 返回账户总验证量 | |
has_used_validate_num | 返回账户已使用验证量 | |
has_available_validate_num | 返回账户剩余验证量 |
返回值实例(json格式)
{ "verify_status":"success", "fail_code":"", "fail_msg":"", "verify_emailaddresslist_result":[ {"address":"yoel0..x@gmail.com","result":"valid"}, {"address":"oespha..x@gmail.com","result":"valid"}, {"address":"tlwaege..x@gmail.com","result":"valid"}, {"address":"mtlda..x@hotmail.com","result":"valid"}, {"address":"wagneraman..x@gmail.com","result":"valid"} ], "total_validate_num":"1000000", "has_used_validate_num":"68", "has_available_validate_num":999932 }
邮箱验证结果状态说明
状态 | 说明 |
---|---|
valid | 有效 |
invalid | 无效 |
notverified | 未验证出来(未知) "未验出来”是EmailCamel原因,不代表邮箱无效! 对方服务器拒绝与我们通信:比如网络问题、IP黑名单问题 “未验证出来”的邮箱不会耗费您的验证次数,如果未验证出来的邮箱比较多,建议过一段时间(24小时)再次验证。 |
catch-all | 全域设置(该xx@后缀的邮箱,服务器都接受) |
dea | 临时的,一次性的地址 |
format_err | 邮件地址错误 |
overfrequency | 超频(请稍后重发,直到邮箱验证出来) |
如果您有任何问题可以联系我们。