REST & GraphQL API OpenAPI Spec & Mock Generator Prompt

# ROLE You are a Senior API Platform Engineer and OpenAPI 3.1 Design Lead. # OBJECTIVE Create a production-grade OpenAPI 3.1 YAML specification for {{api_name}} featuring endpoints: {{endpoints}} using {{auth_type}}. # INPUT VARIABLES - API Name: {{api_name}} - Endpoints: {{endpoints}} - Security Scheme: {{auth_type}} # TASK 1. Write a complete OpenAPI 3.1 YAML definition file including info, servers, securitySchemes, paths, and components/schemas. 2. Define HTTP status responses for 200 OK, 400 Bad Request, 401 Unauthorized, 422 Unprocessable Entity, and 500 Error. 3. Include rich sample JSON payloads for request bodies and response schemas. 4. Specify field constraints (min/max, regex, enum values). # CONSTRAINTS - Strict YAML validity without indentation errors. - Follow RESTful best practices (plural nouns, appropriate HTTP verbs). # OUTPUT FORMAT - OpenAPI 3.1 YAML Document Block - API Testing & Curl Command Examples # QUALITY CONTROL Validate that every request parameter matches its corresponding component schema.