List events for a message
/v1/amb/messages/{message_id}/eventsconst result = await bird.amb.listEvents("amb_01krdgeqcxet5s7t44vh8rt9mg");
console.log(result);result = client.amb.list_events('amb_01krdgeqcxet5s7t44vh8rt9mg')
print(result)result, err := client.Amb.ListEvents(ctx, "amb_01krdgeqcxet5s7t44vh8rt9mg", bird.AmbListEventsParams{})
if err != nil {
log.Fatal(err)
}
fmt.Println(result)$bird->amb->listEvents('amb_01krdgeqcxet5s7t44vh8rt9mg');bird amb list-events <message-id>curl -X GET "https://us1.platform.bird.com/v1/amb/messages/{message_id}/events" \
-H "Authorization: Bearer $TOKEN"{
"data": [
{
"id": "aev_01krdgeqcxet5s7t44vh8rt9mg",
"type": "amb.sent",
"error": {
"code": "bird:business_not_registered",
"description": "Apple refused the message with HTTP status 404."
}
}
]
}
Returns a message's lifecycle events in chronological order, one entry per status transition (amb.accepted, amb.sent, amb.send_failed, amb.received). The timeline is bounded and returned in full, so this list is not paginated. Event history does not expire based on age.
参数
message_idstringMessage identifier. Starts with amb_.
查询参数
typestringKeep only events of this exact type (for example amb.sent or amb.send_failed). Omit for the full timeline.
Possible values (may grow over time): amb.accepted, amb.sent, amb.send_failed, amb.rejected, amb.received
响应载荷
dataThe message's events, oldest first. Not paginated: a message's timeline is bounded and returned in full.
显示子属性
data.idID of the event, unique within the message's timeline.
data.typeMessage timeline event type:
amb.accepted: The API accepted the request.amb.sent: The message was handed to Apple.amb.send_failed: Apple refused the message, or its send attempts were exhausted.amb.rejected: Bird refused the message before any send attempt.amb.received: An inbound message arrived from the customer.
This is an open enum. Accept unrecognized values.
Possible values (may grow over time): amb.accepted, amb.sent, amb.send_failed, amb.rejected, amb.received
data.occurred_atWhen this event occurred.
data.errorFailure detail, on an amb.send_failed or amb.rejected event. Null on every other event type.