zulip/zerver/openapi
Mateusz Mandera a36f906d1a presence: Add history_limit_days param to the API.
This param allows clients to specify how much presence history they want
to fetch. Previously, the server always returned 14 days of history.
With the recent migration of the presence API to the much more efficient
system relying on incremental fetches via the last_update_id param added
in #29999, we can now afford to provide much more history to clients
that request it - as all that historical data will only be fetched once.

There are three endpoints involved:
- `/register` - this is the main useful endpoint for this, used by API
clients to fetch initial data and register an events queue. Clients can
pass the `presence_history_limit_days` param here.
- `/users/me/presence` - this endpoint is currently used by clients to
update their presence status and fetch incremental data, making the new
functionality not particularly useful here. However, we still add the
new `history_limit_days` param here, in case in the future clients
transition to using this also for the initial presence data fetch.
- `/` - used when opening the webapp. Naturally, params aren't passed
here, so the server just assumes a value from
`settings.PRESENCE_HISTORY_LIMIT_DAYS_FOR_WEB_APP` and returns
information about this default value in page_params.
2024-09-10 13:15:35 -07:00
..
__init__.py
curl_param_value_generators.py upload: Provide the frontend with the less-modified filename. 2024-09-09 12:40:17 -07:00
javascript_examples.js api-docs: Update comments in javascript usage examples for channel. 2024-05-20 11:27:03 -07:00
javascript_examples.py python: Simplify with str.removeprefix, str.removesuffix. 2024-09-03 12:30:16 -07:00
markdown_extension.py python: Simplify with str.removeprefix, str.removesuffix. 2024-09-03 12:30:16 -07:00
openapi.py python: Simplify with str.removeprefix, str.removesuffix. 2024-09-03 12:30:16 -07:00
python_examples.py api_docs: Document "/export/realm" endpoints. 2024-08-12 10:12:08 -07:00
test_curl_examples.py models: Replace realm.uri with realm.url. 2024-05-08 11:12:43 -07:00
testing.yaml test_openapi: Make testing.yml a full conformant specification. 2022-01-13 14:34:11 -08:00
zulip.yaml presence: Add history_limit_days param to the API. 2024-09-10 13:15:35 -07:00