Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revisionBoth sides next revision
api:api_journal [2019/11/27 12:37] Lauri Elevantapi:api_journal [2020/07/22 14:51] – [Parameters] Lauri Elevant
Line 21: Line 21:
 | ''byEvents'' | Optional | List of journal events you are interested in | [1] | | ''byEvents'' | Optional | List of journal events you are interested in | [1] |
 | ''bySince'' | Optional | A date or the ID from which you want to start searching from | [2] | | ''bySince'' | Optional | A date or the ID from which you want to start searching from | [2] |
 +| ''order'' | Optional | Should the call return newest events first or oldest first. Legal values are "newest-first" and "oldest-first" (default). If an illegal value is provided, the default will be applied silently. | [3] |
 +| ''limit'' | Optional | How many journal events to return (Allowed range is 1..1024, 1024 being the default). If the limit is exceeded, it is silently capped. | [3] |
  
   * // Note [1]: See the list of journal events below. The list must be comma-separated. All list items are combined with logical ''OR'' operators - in other words a journal event is considered matching if it matches to any of the values provided in the list.//   * // Note [1]: See the list of journal events below. The list must be comma-separated. All list items are combined with logical ''OR'' operators - in other words a journal event is considered matching if it matches to any of the values provided in the list.//
   * // Note [2]: An [[https://en.wikipedia.org/wiki/ISO_8601|ISO 8601 compatible date(time)]] //   * // Note [2]: An [[https://en.wikipedia.org/wiki/ISO_8601|ISO 8601 compatible date(time)]] //
 +  * // Note [3]: For backwards compatibility reasons, the default order/limit are set to  "oldest-first" and 1024, respectively. In many cases, for example when polling for new events,  it makes sense to fetch the last 10 items. In this case, set "order" to "newest-first" and "limit" to 10. //