> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aguasto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Testing and API versioning

> Test against synthetic fixtures, handle retries and understand the public API compatibility policy.

The public integration sandbox uses fixed synthetic search records and calculator inputs. It needs no account and stores no test inputs. Use it to test a matching query, an empty result and invalid input before calling the production research routes.

```bash theme={null}
curl --fail-with-body 'https://www.aguasto.com/api/v1/sandbox'

curl --fail-with-body 'https://www.aguasto.com/api/v1/sandbox' \
  -H 'Content-Type: application/json' \
  -d '{"operation":"search","query":"rack cooling"}'
```

See the [sandbox guide and examples](https://www.aguasto.com/sandbox) and the [live OpenAPI document](https://www.aguasto.com/openapi.json).

## Compatibility

The `/api/v1` contract can add optional fields. Clients should ignore fields they do not recognize. Breaking changes use a new major URL version. Aguasto’s [versioning and deprecation policy](https://www.aguasto.com/developers/versioning) describes its minimum 90-day notice and the `Deprecation` and `Sunset` headers.

## Retry calculations

A calculator request is deterministic for the same v1 inputs. To have the server check input consistency, you can include the optional `Idempotency-Key` documented in the [public API guide](https://www.aguasto.com/developers#idempotency). The service validates the SHA-256 digest of the canonical request and recomputes the result. Use this for calculation retries.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.