不兼容通过Hasura导出的swagger文档（OpenAPI 3.0）

# 使用环境
- Torna版本：1.21.0
- Java版本：1.8
- MySQL版本：5.7
- 浏览器：Chrome

# 描述
我通过Hasura创建的RestfulAPI，官方支持通过url：/api/swagger/json的方式导出API文档。
我尝试在Torna使用swagger导入，但发现响应字段没有任何描述。

这里给一个示例
```
{
    "openapi": "3.0.0",
    "info": {
        "description": "This OpenAPI specification is automatically generated by Hasura.",
        "title": "Rest Endpoints",
        "version": ""
    },
    "paths": {
        "/api/rest/test": {
            "get": {
                "summary": "test",
                "description": "测试***\nThe GraphQl query for this endpoint is:\n``` graphql\nquery test($id: Long!) {\n  accountModule {\n    accountGiveRecordDetail(id: $id) {\n      eventTime\n      operator\n      id\n      num\n    }\n  }\n}\n```",
                "parameters": [
                    {
                        "description": "Your x-hasura-admin-secret will be used for authentication of the API request.",
                        "in": "header",
                        "name": "x-hasura-admin-secret",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "id": {
                                        "$ref": "#/components/schemas/Long!"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    },
                    "description": "Query parameters can also be provided in the request body as a JSON object",
                    "required": true
                },
                "responses": {
                    "200": {
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "accountModule": {
                                            "description": "",
                                            "nullable": true,
                                            "properties": {
                                                "accountGiveRecordDetail": {
                                                    "description": "",
                                                    "nullable": true,
                                                    "properties": {
                                                        "eventTime": {
                                                            "$ref": "#/components/schemas/Long"
                                                        },
                                                        "id": {
                                                            "$ref": "#/components/schemas/Long"
                                                        },
                                                        "num": {
                                                            "nullable": true,
                                                            "title": "Int",
                                                            "type": "integer"
                                                        },
                                                        "operator": {
                                                            "nullable": true,
                                                            "title": "String",
                                                            "type": "string"
                                                        }
                                                    },
                                                    "title": "AccountGiveRecord",
                                                    "type": "object"
                                                }
                                            },
                                            "title": "AccountModuleQuery",
                                            "type": "object"
                                        }
                                    }
                                }
                            }
                        },
                        "description": "Responses for GET /api/rest/test"
                    }
                }
            }
        },
        "/api/rest/test2": {
            "get": {
                "summary": "test2",
                "description": "第二个测试用例***\nThe GraphQl query for this endpoint is:\n``` graphql\nquery test($id: Long!) {\n  accountModule {\n    accountGiveRecordDetail(id: $id) {\n      eventTime\n      operator\n      id\n      num\n      status\n      receiveUserInfoList {\n        mobile\n      }\n    }\n  }\n}\n```",
                "parameters": [
                    {
                        "description": "Your x-hasura-admin-secret will be used for authentication of the API request.",
                        "in": "header",
                        "name": "x-hasura-admin-secret",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "id": {
                                        "$ref": "#/components/schemas/Long!"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    },
                    "description": "Query parameters can also be provided in the request body as a JSON object",
                    "required": true
                },
                "responses": {
                    "200": {
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "accountModule": {
                                            "description": "",
                                            "nullable": true,
                                            "properties": {
                                                "accountGiveRecordDetail": {
                                                    "description": "",
                                                    "nullable": true,
                                                    "properties": {
                                                        "eventTime": {
                                                            "$ref": "#/components/schemas/Long"
                                                        },
                                                        "id": {
                                                            "$ref": "#/components/schemas/Long"
                                                        },
                                                        "num": {
                                                            "nullable": true,
                                                            "title": "Int",
                                                            "type": "integer"
                                                        },
                                                        "operator": {
                                                            "nullable": true,
                                                            "title": "String",
                                                            "type": "string"
                                                        },
                                                        "receiveUserInfoList": {
                                                            "items": {
                                                                "description": "用户手机号",
                                                                "nullable": true,
                                                                "properties": {
                                                                    "mobile": {
                                                                        "nullable": true,
                                                                        "title": "String",
                                                                        "type": "string"
                                                                    }
                                                                },
                                                                "title": "UserMobile",
                                                                "type": "object"
                                                            },
                                                            "nullable": true,
                                                            "type": "array"
                                                        },
                                                        "status": {
                                                            "$ref": "#/components/schemas/IntegralReceiveActivityStatus"
                                                        }
                                                    },
                                                    "title": "AccountGiveRecord",
                                                    "type": "object"
                                                }
                                            },
                                            "title": "AccountModuleQuery",
                                            "type": "object"
                                        }
                                    }
                                }
                            }
                        },
                        "description": "Responses for GET /api/rest/test2"
                    }
                }
            },
            "post": {
                "summary": "test2",
                "description": "第二个测试用例***\nThe GraphQl query for this endpoint is:\n``` graphql\nquery test($id: Long!) {\n  accountModule {\n    accountGiveRecordDetail(id: $id) {\n      eventTime\n      operator\n      id\n      num\n      status\n      receiveUserInfoList {\n        mobile\n      }\n    }\n  }\n}\n```",
                "parameters": [
                    {
                        "description": "Your x-hasura-admin-secret will be used for authentication of the API request.",
                        "in": "header",
                        "name": "x-hasura-admin-secret",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "id": {
                                        "$ref": "#/components/schemas/Long!"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    },
                    "description": "Query parameters can also be provided in the request body as a JSON object",
                    "required": true
                },
                "responses": {
                    "200": {
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "accountModule": {
                                            "description": "",
                                            "nullable": true,
                                            "properties": {
                                                "accountGiveRecordDetail": {
                                                    "description": "",
                                                    "nullable": true,
                                                    "properties": {
                                                        "eventTime": {
                                                            "$ref": "#/components/schemas/Long"
                                                        },
                                                        "id": {
                                                            "$ref": "#/components/schemas/Long"
                                                        },
                                                        "num": {
                                                            "nullable": true,
                                                            "title": "Int",
                                                            "type": "integer"
                                                        },
                                                        "operator": {
                                                            "nullable": true,
                                                            "title": "String",
                                                            "type": "string"
                                                        },
                                                        "receiveUserInfoList": {
                                                            "items": {
                                                                "description": "用户手机号",
                                                                "nullable": true,
                                                                "properties": {
                                                                    "mobile": {
                                                                        "nullable": true,
                                                                        "title": "String",
                                                                        "type": "string"
                                                                    }
                                                                },
                                                                "title": "UserMobile",
                                                                "type": "object"
                                                            },
                                                            "nullable": true,
                                                            "type": "array"
                                                        },
                                                        "status": {
                                                            "$ref": "#/components/schemas/IntegralReceiveActivityStatus"
                                                        }
                                                    },
                                                    "title": "AccountGiveRecord",
                                                    "type": "object"
                                                }
                                            },
                                            "title": "AccountModuleQuery",
                                            "type": "object"
                                        }
                                    }
                                }
                            }
                        },
                        "description": "Responses for POST /api/rest/test2"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "Long!": {
                "description": "Long type",
                "nullable": false,
                "title": "Long"
            },
            "Long": {
                "description": "Long type",
                "nullable": true,
                "title": "Long"
            },
            "IntegralReceiveActivityStatus": {
                "description": "积分赠送活动状态",
                "enum": [
                    "NOT_SEND",
                    "SEND"
                ],
                "nullable": true,
                "title": "IntegralReceiveActivityStatus"
            }
        }
    }
}
```

tanghc/torna

内容风险标识

评论 (0)

tanghc/torna .gitee-modal { width: 500px !important; }

内容风险标识