The OpenAPI Specification (OAS) is a language-agnostic specification that describes API definitions. It is widely used by developers at the API design stage. With the OAS’s declarative specification (YAML and JSON), the developer can define API interface without the knowledge of server implementation or access to the server code.
Beeceptor takes your OAS to next level by hosting a mock server with just one click. You can now upload the specification file to an endpoint and start serving requests.
This feature is available with paid plans and provided as beta preview only.
Upload OpenAPI Specification
Beeceptor accepts YAML or JSON representation. You can open OAS setup screen by navigating as Account Menu > Your Endpoints > Settings for the selected endpoint.
The following screenshot is an example to upload a specification file. In addition,
- You can also download already configured specification
- You can cleanup any uploaded specification.
The support for OSA is implicit in Beeceptor. Once the specification is uploaded and parsed successfully, Beeceptor tries to match the incoming request path as per the OAS definition. A sample mocked response is returned by default matching the API response's meta definition.
For example, consider a Pets API's OAS as below where the following
Pet schema definition is declared for find-all-pets-by-tags API with
When the OAS matcher at Beeceptor matches a
GET request on
/pet/findByTags endpoint, it returns following mocked response:
You can override this response by creating a new mocking rule. A custom mocking rule gets higher precedence over default OAS response.
If you have further questions, feel free to reach out to support.