# Mocking

OpenAPI allows to include *examples* in the API definition. FLAT uses [response examples](https://swagger.io/docs/specification/2-0/adding-examples/#responses) to implement an easy to use mock server.

Mocking can be activated by the client with the HTTP header

```
Mock: true
```

If given, FLAT will look for the `examples` of the API path's `200` `responses` section for an example with a content-type that matches the inbound `Accept` header.

[Mocked responses from upstream](https://sevenval.gitbook.io/flat/openapi-6/upstream#mocking) work just the same way.

## Example

The [cookbook](https://sevenval.gitbook.io/flat/cookbook) has a recipe for the [built-in mocking](https://sevenval.gitbook.io/flat/cookbook/builtin-mocking).

## Configuration

To avoid accidentally running on mocks in production, mocking has to be explicitly activated with the `FLAT_ALLOW_MOCKING` environment variable (default `false`):

```
FLAT_ALLOW_MOCKING=true
```