Master Data’s scroll endpoint sometimes returns a 408 error

Known issues

ID:

Backlog

Published on 6/12/2019

•

Last update on 12/22/2022

Summary

In some cases, when requesting large amounts of data through our scroll endpoint, Master Data will timeout. Executing the first call once more will result in success.

Simulation

http://api.vtex.com/\{\{accountName\}\}/dataentities/\{\{acronym\}\}/scroll?isCluster=true&_size=250&_fields=email,firstName

Receive a timeout

Workaround

Timeouts can be mitigated by reducing the first request’s size. This can be done by adjusting the value, in this case from 1000 to 20:

Before

http://api.vtex.com/\{\{accountName\}\}/dataentities/\{\{acronym\}\}/scroll?isCluster=true&_size=1000&_fields=email,firstName

After

http://api.vtex.com/\{\{accountName\}\}/dataentities/\{\{acronym\}\}/scroll?isCluster=true&_size=250&_fields=email,firstName