邮件接口
邮件类型定义
发送邮件
接口
/mail/send
接口字段说明 (POST数据)
发送邮件请求描述
| 参数 | 类型 | 是否必填 | 描述 |
|---|
| mail_to | string | 是 | 邮件接收者openid |
| mail_detail | json | 是 | 邮件内容（参照MailDetail字段描述） |
| 参数 | 类型 | 是否必填 | 描述 |
|---|
| type | int | 是 | 邮件类型（参考邮件类型定义） |
| from | string | 是 | 发送者openid |
| reason | int | 是 | 原因 |
| subject | string | 否 | 邮件标题 |
| content | string | 否 | 邮件内容 |
| from_nick | string | 否 | 发送者昵称 |
| from_pic | string | 否 | 发送者名字 |
| send_timestamp | int64 | 否 | 发送时间戳 |
| expire_timestamp | int64 | 否 | 过期时间戳 |
| buff_data | bytes | 否 | 自定义buff数据(最大长度1024 byte) |
| buff_len | int | 否 | 自定义buff数据长度 |
发送邮件请求返回描述
| 参数 | 类型 | 描述 |
|---|
| ret | int | 返回值 （0-成功 其他-失败） |
调用示例
curl -X POST -d '{"mail_to":"abc233", "mail_detail":{"type":3,"from":"abc123","buff_data":"12334567abc","buff_len":10}}' 'http://9.140.233.132:9311/mail/send?appid=10002&app_plat=3&openid=abc123'
1
更新邮件
接口
/mail/charge
接口字段说明 (POST数据)
更新邮件请求描述
| 名称 | 值 | 描述 |
|---|
| 领取 | 1 | 领取邮件 |
| 删除 | 2 | 删除邮件 |
| 领取并删除 | 3 | 领取并删除邮件 |
| 读取 | 4 | 读取邮件 |
| 参数 | 类型 | 是否必填 | 描述 |
|---|
| type | int | 是 | 邮件类型（参考邮件类型定义） |
| update_type | int | 是 | 邮件更新类型（参考MailUpdateType定义） |
| mail_index_list | int array | 否 | 邮件编号列表 （不填表示更新所有此类型的邮件） |
更新邮件返回参数描述
| 参数 | 类型 | 描述 |
|---|
| ret | int | 返回值 （0-成功 其他-失败） |
| type | int | 请求时的邮件类型（参考邮件类型定义） |
| mail_data_list | json array | 邮件数据列表(参考MailData字段描述) |
| 参数 | 类型 | 描述 |
|---|
| index | int | 邮件编号 |
| buff_data | bytes | 自定义buff数据(最大长度1024 byte) |
| buff_len | int | 自定义buff数据长度 |
| status | int | 邮件状态（参考MailStatusBit描述） |
| 名称 | 值 | 描述 |
|---|
| 读取状态位 | 0x01 | 此位为1时表示邮件已读 |
| 领取状态位 | 0x02 | 此位为1时表示邮件领取 |
调用示例
curl -X POST -d '{"type":3,"uptdae_type":1,"mail_index_list":[0,1,2,3]}' 'http://9.140.233.132:9311/mail/send?appid=10002&app_plat=3&openid=abc123
1