# Generated by ShowAPI OpenAPI generator # source: market/1620 # generated-at: 2026-09-24T08:00:39.132Z openapi: 3.0.3 info: title: 唐诗宋词元曲等诗词查询 description: 本API提供集成唐诗、宋词、元曲等古典诗词的查询服务，汇集众多诗人作品，助您便捷探索中国古典文学精髓。 termsOfService: https://www.showapi.com/helpcenter/view#/4019/2 version: 1.0.0 servers: - url: https://route.showapi.com paths: /1620-5: x-pointCode: 5 x-mode: mapping x-read-timeout: 15 x-connect-timeout: 15 post: summary: 名称查询诗词列表 description: 提供诗词查询接口，通过诗人ID获取对应的诗词集合。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: string description: 接口调用是否成功,0为成功,其他为失败 remark: type: string description: 提示信息 poemInfo: type: array items: type: object properties: title: type: string description: 诗名 dynasty: type: string description: 朝代 dynastyId: type: string description: 朝代Id poemId: type: string description: 诗Id poetId: type: string description: 诗人Id poet: type: string description: 诗人 contentlist: type: array items: type: object properties: original: type: string description: 原文 translation: type: string description: 译文 annotation: type: string description: 注释 description: 原文、译文、注释 description: 诗词列表 description: 业务返回体 operationId: 1620_5_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: poetId: type: string description: 诗人id title: type: string description: 诗词名称（不支持模糊查询） page: type: string description: 页码 /1620-4: x-pointCode: 4 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 人名或朝代查询诗人 description: 这是一个诗词查询API的接口，可根据朝代ID或诗人名称检索诗人信息。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: string description: 接口调用是否成功,0为成功,其他为失败 remark: type: string description: | 提示信息 datas: type: array items: type: object properties: poet: type: string description: 诗人 poetId: type: string description: 诗人Id dynasty: type: string description: 朝代 dynastyId: type: string description: 朝代Id biography: type: string description: 生平简介 description: 诗人列表 allPages: type: number description: 总页数 currentPage: type: number description: 当前页 allNum: type: number description: 总数 maxResult: type: number description: 当前页最大数 description: 业务返回体 operationId: 1620_4_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: dynastyId: type: string description: 朝代Id poet: type: string description: 诗人 page: type: string description: 页码 /1620-3: x-pointCode: 3 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 查询朝代列表 description: 提供查询朝代列表的API接口，可检索如宋代、唐代、南北朝等朝代的诗词信息。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: string description: 接口调用是否成功,0为成功,其他为失败 remark: type: string description: 提示信息 dynastyInfo: type: array items: type: object properties: dynasty: type: string description: 朝代 dynastyId: type: string description: 朝代Id description: 朝代信息 description: 业务返回体 operationId: 1620_3_POST parameters: [] components: securitySchemes: AppKeyAuth: type: apiKey in: query name: appKey description: 从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp schemas: ShowapiResEnvelope: type: object description: ShowAPI 统一返回包裹（业务数据位于 showapi_res_body） properties: showapi_res_code: type: integer description: API 返回的状态码 showapi_res_error: type: string description: API 返回的错误信息 showapi_res_id: type: string description: API 请求的唯一标识 showapi_fee_num: type: integer description: API 调用计费次数 security: - AppKeyAuth: [] externalDocs: url: https://www.showapi.com/apis/1620?tab=book x-apiCode: "1620" x-is-own: false x-is-op: false