DCAS handbook

Long-poll API

Available on builds with longpoll feature enabled.

‘Long-poll’ routes provides an API that enable mobile devices to perform a “long-polling” of the server and post a notifications for user.

Routes

As of November 2025, long-poll API provides only one endpoint which is served from the main HTTP server (aka API server):

GET http://main.server/poll/v1/main?timeout=...

Nginx config

To make notifications work properly, raise nginx proxy timeout for /poll/ sub-urls using something similar to this config section:

# Long-poll endpoint needs higher timeouts
location /poll/ {
    proxy_pass http://127.0.0.1:9000/poll/;

    # Disable caching
    proxy_cache off;

    # Raise timeouts
    client_body_timeout         120m;
    proxy_connect_timeout       120m;
    proxy_send_timeout          120m;
    proxy_read_timeout          120m;
    send_timeout                120m;
}