api - SendGrid 电子邮件活动 API 没有结果

Question

我正在使用此文档尝试从 SendGrid 电子邮件活动 API 接收退回信息：

https://sendgrid.com/docs/for-developers/sending-email/getting-started-email-activity-api/#filter-by-bounced-emails

但它没有返回任何结果，尽管我们的仪表板上显示了大约 50 次反弹（可从 SendGrid Web 界面的“活动”部分查看）。

要求：

curl --request GET \
 --url 'https://api.sendgrid.com/v3/messages?limit=100&query=status%3D%22bounced%22' \
 --header 'authorization: Bearer <<TOKEN_REMOVED>>'

回复：

{"messages":[]}

显然 <<TOKEN_REMOVED>> 是我运行它时的实际令牌:)

注意 -当我使用v3/suppression/bounces端点返回它工作正常的所有内容时（响应大量的退回 JSON），但是我希望能够使用更灵活的messages端点来查询特定的电子邮件等。

curl --request GET \
--url https://api.sendgrid.com/v3/suppression/bounces \
--header 'accept: application/json' \
--header 'authorization: Bearer <<TOKEN_REMOVED>>' \ 
--header 'content-type: application/json' \
--data '{}' \

标签： apisendgridsendgrid-api-v3email-bounces

Answer 1

有两个地方记录了消息 API 的使用：

• “入门”文档
• API 文档

但是关于status查询参数，“入门”指南有过时的示例，其中错误地包括&query=status%3D%22bounced%22'.

在查询参考中明确提到status只能是以下之一：

有效值包括“delivered”、“not_delivered”和“processing”

然而，由于 sendgrid 还依赖其自己的/messagesAPI 来检索 GUI 中的值，因此检查流量显示它使用type查询参数来识别退回（见下图）。

免责声明：此type参数似乎没有记录在案，因此使用它需要您自担风险。

进一步阅读：如果您想在不定期轮询端点的情况下以被动方式获知失败的电子邮件事件/messages，您应该查看 sendgrid 的webhook 机制，它将调用您选择的端点，以便向您提供有关电子邮件状态的信息，包括它是否反弹。