首页 帮助中心 API

查询邮件发送结果

说明: 查询指定emailId集合的发送结果。

请求参数说明:

参数 说明 是否必填 类型

appId

应用id(邮件-邮件应用)

String

emailId

sendEmail接口响应返回的平台id、batchSendEmail接口平台回调的ID,多个用英文逗号分隔。单次查询最大200个emailId

String

请求URL:

                      
                        https://api.onbuka.com/v3/email/getSendEmailRcd?appId={appId}&emailId={emailId}
                      
                    

GET请求示例:

                      
                        Request URL:
                            https://api.onbuka.com/v3/email/getSendEmailRcd?appId=fKFtblIy&emailId=2208031112341000001%2C2208031112361000002
                        Request Method:
                            GET
                        Request Headers:
                            Content-Type: application/json;charset=UTF-8
                            Sign: 05d7a50893e22a5c4bb3216ae3396c7c
                            Timestamp: 1630468800
                            Api-Key: bDqJFiq9
                      

                    

POST请求示例:

                      
                        Request URL:
                            https://api.onbuka.com/v3/email/getSendEmailRcd
                        Request Method:
                            POST
                        Request Headers:
                            Content-Type: application/json;charset=UTF-8
                            Sign: 05d7a50893e22a5c4bb3216ae3396c7c
                            Timestamp: 1630468800
                            Api-Key: bDqJFiq9
                        Request Body:
                            {
                                "appId":"fKFtblIy",
                                "emailId":"2208031112341000001,2208031112361000002"
                            }
                      

                    

响应参数说明:

参数 说明 类型

status

状态码,0成功,其他失败参见邮件状态码说明

String

success

发送成功的邮件封数

String

fail

发送失败的邮件封数

String

sending

正在发送的封数

String

nofound

Id未找到的条数(包含队列中的邮件)

String

array

找到发送结果的json集合

JSONArray

  emailId

提交邮件对应平台emailId

String

  toAddress

提交收件人地址(邮箱地址)

String

  receiveTime

发送时间,ISO8601标准时间格式(2021-02-12T09:30:03+08:00)

String

  status

发送状态:0发送成功,-1:发送中,1:发送失败

String

注:提交发送邮件成功后,系统会给每个提交成功的号码对应生成一个平台emailId,后续客户可以根据这个emailId来查询该邮件的发送结果。

响应示例:

                     
                        {
                                "status": "0",
                                "reason": "success",
                                "success": "0",
                                "fail": "2",
                                "sending": "0",
                                "nofound": "0",
                                "array": [
                                    {
                                        "emailId": "2208031112341000001",
                                        "toAddress": "123@qq.com",
                                        "receiveTime": "",
                                        "status": "1"
                                    },
                                    {
                                        "emailId": "2208031112361000002",
                                        "toAddress": "1234@163.com",
                                        "receiveTime": "",
                                        "status": "1"
                                    }
                                ]
                            }
                    
                  
 

上一篇: 批量发送邮件
下一篇: 查询模板信息

意见反馈

0/500