Latency
Why is there variability across API requests?
API latency is affected by a few factors, mainly the following:
Type of Endpoint: Different endpoints utilize different underlying architectures. The providers endpoint uses a search infrastructure to find relevant providers across different parameters, while the reference endpoints are a direct lookup.
Query Parameters: Using a higher number of query parameters or computationally heavy ones. Right now, specialties and insurances filtering have the highest impact on API latency.
Fields: The number of fields included in the API response (controlled by the fields parameter)
Recommendations
Depending on whether your use case allows for it, we would recommend the following optimizations to H1's API in order to decrease latency.
- Using
fieldsor_excl_fieldsparameters to filter down the API response - Lowering the
page_size(we generally recommend the default of 25) - When editing, applying the
async=true, which will apply edits asynchronously
Updated about 2 months ago
