Events
Every action performed on your account, or on the lists and items in your account is logged as an event. This allows you to view historical activity for every list and item.
{ "action": "Update", "data": "<Event data>", "id": "<Event id>", "object_id": "<Object id>", "object_type": "Item", "time": "2015-03-21T22:11:50+00:00" }
Event fields
action |
The action performed in this event. Possible values are:
|
data |
A JSON object containing information about the event. This object will contain a
details field with a description of the action that was
performed, and will usually also contain further information associated with the event.
For example, for Create and
Update events, the event data will usually contain a
copy of the data that was sent as part of the request. Item data stored in events is truncated to 255 characters. |
id | The event's unique id. |
object_id | The unique id of the object associated with this event. |
object_type |
The type of object associated with this event. Possible values are:
|
time | The time for this event. See Timestamps for information on timestamp format. |
Sorting events
Default |
time descending: true |
time | Events are always sorted by time. |
Event routes
GET events
Return a list of events for your account.
Example request $ curl https://jsonpad.io/api/v1.0/events \ -u username:token \ -H "Accept: application/json"
Example response
{
"descending": true,
"events": [
{
"action": "Update",
"data": {
"details": "Item updated."
},
"id": "23938841534529545",
"object_id": "23928779684446646",
"object_type": "Item",
"time": "2015-03-21T22:11:50+00:00"
},
// Events continued...
],
"page": 1,
"page_size": 50,
"pages": 25,
"sort": "time",
"total": 1256
}
GET events/{id}
Return the specified event.
Example request $ curl https://jsonpad.io/api/v1.0/events/23938841534529545 \ -u username:token \ -H "Accept: application/json"
Example response
{
"event": {
"action": "Update",
"data": {
"details": "Item updated."
},
"id": "23938841534529545",
"object_id": "23928779684446646",
"object_type": "Item",
"time": "2015-03-21T22:11:50+00:00"
}
}