API API Documentation & Specification 3

Question 1

What does 'spec-based testing' mean in API quality assurance?

Accepted Answer

Generating and running tests automatically from the OpenAPI specification

Answer

Testing only based on assumptions

Answer

Testing the spec document for typos

Answer

Running manual tests based on documentation

Question 2

Which tool uses an OpenAPI or API Blueprint spec to run contract tests against a live API?

Accepted Answer

Dredd

Answer

k6

Answer

Locust

Answer

OWASP ZAP

Question 3

What is the purpose of the 'servers' section in an OpenAPI 3.0 specification?

Accepted Answer

Define the base URLs where the API is hosted (e.g., production, staging)

Answer

List authorized API consumers

Answer

Configure server-side caching

Answer

Set rate limit policies

Question 4

What does 'changelog' maintenance mean in the context of API documentation best practices?

Accepted Answer

Documenting every breaking and non-breaking change between API versions

Answer

Logging all API requests

Answer

Auditing who accesses the API

Answer

Tracking server performance changes

Question 5

What is the 'discriminator' keyword used for in OpenAPI polymorphism?

Accepted Answer

Indicate which sub-schema to use when a field's value determines the object type

Answer

Filter out invalid requests

Answer

Authenticate requests

Answer

Define rate limit tiers

Question 6

Which HTTP header is used by APIs to indicate which version is being served?

Accepted Answer

X-API-Version or a custom versioning header

Answer

Content-Type

Answer

Accept-Encoding

Answer

Authorization