{"note":"OpenAPI conversion -- returning structured metadata","name":"color-pizza","description":"Color Name API","version":"1.1.0","base_url":"https://api.color.pizza/","endpoints":7,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Color Name API\n@base https://api.color.pizza/\n@version 1.1.0\n@endpoints 7\n@toc root(1), health(1), docs(1), v1(1), names(1), lists(1), swatch(1)\n\n@group root\n@endpoint GET /\n@desc Get API metadata and discovery information\n@returns(200) {name: str, version: str, description: str, endpoints: map{colors: str, colorsByPath: str, names: str, lists: str, swatch: str, docs: str, health: str}, documentation: str, source: str} # OK - Returns API metadata\n\n@endgroup\n\n@group health\n@endpoint GET /health\n@desc Health check endpoint\n@returns(200) {status: str, timestamp: str(date-time)} # OK - API is healthy and operational\n\n@endgroup\n\n@group docs\n@endpoint GET /v1/docs/\n@desc Get API Documentation\n@returns(200) OK - Returns the HTML documentation page.\n\n@endgroup\n\n@group v1\n@endpoint GET /v1/\n@desc Get color names for specific hex values\n@returns(200) {colors: [map], paletteTitle: str} # OK\n@errors {400: BAD REQUEST, 404: NOT FOUND, 409: CONFLICT - Requested more unique colors than available}\n\n@endgroup\n\n@group names\n@endpoint GET /v1/names/\n@desc Search for colors by name\n@returns(200) {colors: [map]} # OK\n@errors {404: NOT FOUND}\n\n@endgroup\n\n@group lists\n@endpoint GET /v1/lists/\n@desc Get available color name lists\n@optional {list: str # The name of a specific color name list to retrieve details for}\n@returns(200) OK\n@errors {400: BAD REQUEST, 404: NOT FOUND}\n\n@endgroup\n\n@group swatch\n@endpoint GET /v1/swatch/\n@desc Generate a color swatch for any color\n@required {color: str # The hex value of the color to retrieve without '#'}\n@optional {name: str # The name of the color to display on the swatch}\n@returns(200) OK\n@errors {400: BAD REQUEST}\n\n@endgroup\n\n@end\n"}