swagger.json

{
    "swagger": "3.0",
    "info": {
        "title": "",
        "version": "0.0.0",
        "description": ""
    },
    "paths": {
        "/test_api": {
            "post": {
                "tags": ["search"],
                "summary": "test_api_name",
                "description": "desc_test_api",
                "consumes": ["application/json"],
                "produces": ["application/json"],
                "parameters": [{
                    "type": "string",
                    "in": "query",
                    "name": "bar",
                    "description": "desc_bar",
                    "required": true,
                    "default": "bar"
                }, {
                    "type": "string",
                    "in": "header",
                    "name": "taz",
                    "description": "desc_taz",
                    "required": false
                }, {
                    "in": "body",
                    "schema": {
                        "$schema": "http://json-schema.org/draft-04/schema#",
                        "title": "request_desc",
                        "type": "object",
                        "properties": {
                            "code": {
                                "type": "number"
                            },
                            "data": {
                                "type": "object",
                                "properties": {
                                    "keyInExtraExample": {
                                        "type": "number"
                                    }
                                }
                            },
                            "foo": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "foz": {
                                            "type": "string",
                                            "description": "desc_foo.foz"
                                        }
                                    },
                                    "required": ["foz"]
                                }
                            },
                            "tar": {
                                "type": "number",
                                "description": "desc_tar"
                            }
                        },
                        "required": ["foo"]
                    },
                    "description": "request_desc"
                }],
                "responses": {
                    "200": {
                        "schema": {
                            "$schema": "http://json-schema.org/draft-04/schema#",
                            "title": "response_desc",
                            "type": "object",
                            "properties": {
                                "code": {
                                    "type": "number",
                                    "description": "desc_override_code",
                                    "default": "1"
                                },
                                "data": {
                                    "type": "object",
                                    "properties": {
                                        "keyInExample": {
                                            "type": "number"
                                        },
                                        "keyInDoc": {
                                            "type": "number",
                                            "description": "desc_add_extra_data_key_in_doc"
                                        }
                                    },
                                    "required": ["keyInDoc"]
                                }
                            },
                            "required": ["data"]
                        },
                        "description": "response_desc"
                    },
                    "300": {
                        "schema": {
                            "$schema": "http://json-schema.org/draft-04/schema#",
                            "title": "error_desc",
                            "type": "object",
                            "properties": {
                                "bazInJs": {
                                    "type": "string"
                                }
                            }
                        },
                        "description": "error_desc"
                    }
                }
            }
        }
    }
}