{
  "openapi": "3.0.3",
  "info": {
    "title": "文本处理",
    "description": "文本处理API是一款功能强大的文本分析服务，提供文本分词、关键信息抽取、分类、词性语法分析等功能。该API具有高效、准确、灵活和易用的特点，兼容多种编程语言和平台，适合各种用户在多种场景下使用。",
    "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://route.showapi.com"
    }
  ],
  "paths": {
    "/2663-13": {
      "x-pointCode": 13,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "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": {
                            "simpleData": {
                              "type": "string",
                              "description": "简写拼音"
                            },
                            "ret_code": {
                              "type": "number",
                              "description": "成功为0，其它不成功"
                            },
                            "flag": {
                              "type": "boolean"
                            },
                            "data": {
                              "type": "string",
                              "description": "拼音信息，中间用空格隔开"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_13_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "content": {
                    "type": "string",
                    "description": "内容"
                  }
                },
                "required": [
                  "content"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-12": {
      "x-pointCode": 12,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "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": "number",
                              "description": "成功为0，其余不成功"
                            },
                            "flag": {
                              "type": "boolean"
                            },
                            "data": {
                              "type": "string",
                              "description": "转换后的繁体字"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_12_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "content": {
                    "type": "string",
                    "description": "内容"
                  }
                },
                "required": [
                  "content"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-11": {
      "x-pointCode": 11,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "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": "number",
                              "description": "成功为0，其余不成功"
                            },
                            "flag": {
                              "type": "boolean"
                            },
                            "data": {
                              "type": "string",
                              "description": "转换后的简体"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_11_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "content": {
                    "type": "string",
                    "description": "内容"
                  }
                },
                "required": [
                  "content"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-10": {
      "x-pointCode": 10,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "post": {
        "summary": "语义距离",
        "description": "通过测量语义距离的方式，推测语义相似度情况",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "distance": {
                              "type": "number",
                              "description": "距离（数字越小，词义越相近）"
                            },
                            "ret_code": {
                              "type": "number",
                              "description": "成功为0，其它不成功"
                            },
                            "remark": {
                              "type": "string",
                              "description": "返回描述"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_10_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "word1": {
                    "type": "string",
                    "description": "词语1"
                  },
                  "word2": {
                    "type": "string",
                    "description": "词语2"
                  }
                },
                "required": [
                  "word1",
                  "word2"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-9": {
      "x-pointCode": 9,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "post": {
        "summary": "文本推荐",
        "description": "根据用户输入的文本自动推荐的更多同类型文档和具有相关性的文本。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "ret_code": {
                              "type": "number",
                              "description": "成功为0，其它不成功"
                            },
                            "remark": {
                              "type": "string",
                              "description": "返回描述"
                            },
                            "list": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "推荐文本列表"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_9_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "text_list": {
                    "type": "string",
                    "description": "文本（以@@@分隔多个）"
                  },
                  "keyword": {
                    "type": "string",
                    "description": "关键字"
                  },
                  "num": {
                    "type": "string",
                    "description": "推荐数量，默认：2"
                  }
                },
                "required": [
                  "text_list",
                  "keyword"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-8": {
      "x-pointCode": 8,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "post": {
        "summary": "依存句法分析",
        "description": "依存句法分析，是指识别语句中词与词之间的依存关系，并揭示其句法结构，包括主谓关系、动宾关系、核心关系等。用依存语言学来理解语义，精准掌握用户意图",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "ret_code": {
                              "type": "number",
                              "description": "成功为0，其它不成功"
                            },
                            "remark": {
                              "type": "string",
                              "description": "返回描述"
                            },
                            "sentences": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "description": "结点id"
                                  },
                                  "lemma": {
                                    "type": "string",
                                    "description": "词语的原词和次干"
                                  },
                                  "cpos": {
                                    "type": "string",
                                    "description": "词性（粗）"
                                  },
                                  "hear_word_id": {
                                    "type": "string",
                                    "description": "头结点id。如果是根节点，默认为0"
                                  },
                                  "deprel": {
                                    "type": "string",
                                    "description": "词语与中心词的依存关系"
                                  },
                                  "pos": {
                                    "type": "string",
                                    "description": "词性（细）"
                                  }
                                }
                              },
                              "description": "依存关系"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_8_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "内容"
                  }
                },
                "required": [
                  "text"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-7": {
      "x-pointCode": 7,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "post": {
        "summary": "摘要抽取",
        "description": "从给定文档中总结出文档的主要内容，并提供简明扼要的文字描述，自动摘要可应于用于搜索结果片段生成、学术文献综述、舆情报告等场合",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "ret_code": {
                              "type": "number",
                              "description": "成功为0，其余不成功"
                            },
                            "remark": {
                              "type": "string",
                              "description": "返回描述"
                            },
                            "list": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "摘要列表"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_7_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "内容"
                  },
                  "num": {
                    "type": "string",
                    "description": "返回个数"
                  }
                },
                "required": [
                  "text"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-6": {
      "x-pointCode": 6,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "post": {
        "summary": "关键词抽取",
        "description": "在海量文本中提取出能够反映主题或者主要内容的词或短语。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "ret_code": {
                              "type": "number",
                              "description": "成功为0，其余不成功"
                            },
                            "remark": {
                              "type": "string",
                              "description": "返回描述"
                            },
                            "list": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "关键词列表"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_6_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "内容"
                  },
                  "num": {
                    "type": "string",
                    "description": "返回个数"
                  }
                },
                "required": [
                  "text"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-5": {
      "x-pointCode": 5,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "post": {
        "summary": "短语提取",
        "description": "依据文档内容，提取出相关性靠前的短语来概括文档内容",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "ret_code": {
                              "type": "number",
                              "description": "成功为0，其余不成功"
                            },
                            "remark": {
                              "type": "string",
                              "description": "返回描述"
                            },
                            "list": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "短语列表"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_5_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "内容"
                  },
                  "size": {
                    "type": "string",
                    "description": "返回短语的个数"
                  }
                },
                "required": [
                  "text"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-4": {
      "x-pointCode": 4,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "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": "number",
                              "description": "成功为0，其余不成功"
                            },
                            "remark": {
                              "type": "string",
                              "description": "返回描述"
                            },
                            "organs": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "word": {
                                    "type": "string",
                                    "description": "机构名"
                                  },
                                  "pos": {
                                    "type": "string",
                                    "description": "词性"
                                  }
                                }
                              },
                              "description": "机构名列表"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_4_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "需要识别地名的内容"
                  }
                },
                "required": [
                  "text"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-3": {
      "x-pointCode": 3,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "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": "number",
                              "description": "成功为0，其余不成功"
                            },
                            "remark": {
                              "type": "string",
                              "description": "返回描述"
                            },
                            "places": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "word": {
                                    "type": "string",
                                    "description": "地名"
                                  },
                                  "pos": {
                                    "type": "string",
                                    "description": "词性"
                                  }
                                }
                              },
                              "description": "地名列表"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_3_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "需要识别地名的内容"
                  }
                },
                "required": [
                  "text"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-2": {
      "x-pointCode": 2,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "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": "number",
                              "description": "成功为0，其余不成功"
                            },
                            "remark": {
                              "type": "string",
                              "description": "返回描述"
                            },
                            "names": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "word": {
                                    "type": "string",
                                    "description": "人名"
                                  },
                                  "pos": {
                                    "type": "string",
                                    "description": "词性"
                                  }
                                }
                              },
                              "description": "人名列表"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_2_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "需要识别人名的内容"
                  },
                  "type": {
                    "type": "string",
                    "description": "分词类型：\n默认：中文\n音译：trans\n日本人名：jpn"
                  }
                },
                "required": [
                  "text"
                ]
              }
            }
          }
        }
      }
    },
    "/2663-1": {
      "x-pointCode": 1,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "post": {
        "summary": "中文分词",
        "description": "中文分词（N-最短路径分词、CRF分词、索引分词、词性标注）",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "ret_code": {
                              "type": "number",
                              "description": "成功为0，其余不成功"
                            },
                            "words": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "word": {
                                    "type": "string",
                                    "description": "词语"
                                  },
                                  "pos": {
                                    "type": "string",
                                    "description": "词性"
                                  }
                                }
                              }
                            },
                            "remark": {
                              "type": "string",
                              "description": "返回描述"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "2663_1_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "需要分词的内容"
                  },
                  "type": {
                    "type": "string",
                    "description": "分词类型：\n默认：标准分词\nnlp：NLP分词\nindex：索引分词\nnShort：N-最短路径分词\ncrf：CRF分词\nfast：极速词典分词"
                  }
                },
                "required": [
                  "text"
                ]
              }
            }
          }
        }
      }
    }
  },
  "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/apiGateway/view/2663?tab=book"
  },
  "x-apiCode": "2663",
  "x-is-own": true,
  "x-is-op": true
}