{
"openapi": "3.0.3",
"info": {
"title": "猜一猜",
"description": "专为社交娱乐、教育科普、营销裂变场景设计的谜语服务中枢，集成搞笑、字谜、成语、科普、节日彩蛋等12类主题的2.5万+优质谜题，支持按难度分级、情感标签、文化属性精准调用，让猜谜变得有趣又富有挑战性。",
"termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2",
"version": "1.0.0"
},
"servers": [
{
"url": "https://route.showapi.com"
}
],
"paths": {
"/151-4": {
"x-pointCode": 4,
"x-mode": "mapping",
"x-read-timeout": 30,
"x-connect-timeout": 30,
"post": {
"summary": "根据类型和关键词查询谜语",
"description": "谜语查询服务接口API：提供根据类型和关键词查询谜语的功能。\n如，类型：搞笑；谜面：显示上海连日有雨 （打一电影名）；谜底：雷神。",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"pb": {
"type": "array",
"items": {
"type": "object",
"properties": {
"allNum": {
"type": "string",
"description": "总记录数"
},
"allPage": {
"type": "string",
"description": "总页数"
},
"contentlist": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "谜面"
},
"answer": {
"type": "string",
"description": "谜底"
},
"typeId": {
"type": "string",
"description": "类型id"
},
"typeName": {
"type": "string",
"description": "类型名称"
}
}
},
"description": "内容列表"
},
"currentPage": {
"type": "string",
"description": "当前页"
},
"maxResult": {
"type": "string",
"description": "每页最大记录数"
}
}
},
"description": "分页对象"
},
"ret_code": {
"type": "string",
"description": "0为成功，其他失败。"
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "151_4_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"typeId": {
"type": "string",
"description": "搞笑=gxmy,
字谜=zmmy,
成语=cymy,
动物=dwmy,
爱情=aqmy,
灯谜=dmmy,
人名=rmmy,
地名=dimmy,
词语=cy,
带格=dgmy,
用语=ry,
儿童=etmy,
物品=wpmy,
植物=zwmy,
名谜=jmmy,
书报=sbmy,
俗语=symy,
药品=ypmy,
音乐=yymy,
影视=ysmy,
称谓=cwmy,
趣味=qtmy,
精选=miyujingxuan,
脑筋急转弯=njmy,
智力问答=zlmy
"
},
"page": {
"type": "string",
"description": "页数"
}
}
}
}
}
}
}
},
"/151-3": {
"x-pointCode": 3,
"x-mode": "mapping",
"x-read-timeout": 5,
"x-connect-timeout": 5,
"post": {
"summary": "谜语类型查询",
"description": "类型：搞笑,字谜,成语,动物,爱情,灯谜,人名,地名,词语,带格,用语,儿童,物品,植物,名谜,书报,俗语,药品,音乐,影视,称谓,趣味,精选,故事,脑筋急转弯,智力问答",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"typeList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "类型id"
},
"name": {
"type": "string",
"description": "类型名称"
}
}
},
"description": "类型列表"
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "151_3_POST",
"parameters": []
}
},
"/151-2": {
"x-pointCode": 2,
"x-mode": "mapping",
"x-read-timeout": 5,
"x-connect-timeout": 5,
"post": {
"summary": "随机查询谜语",
"description": "随机返回20条谜语,通过调用该API，用户可以轻松获取到随机挑选的20条谜语，丰富自己的知识储备和娱乐生活。",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"Title": {
"type": "string",
"description": "谜题"
},
"Answer": {
"type": "string",
"description": "谜底"
},
"typeId": {
"type": "string",
"description": "类型id"
},
"typeName": {
"type": "string",
"description": "类型名称"
},
"ret_code": {
"type": "string",
"description": "0为成功，其他失败"
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "151_2_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"typeId": {
"type": "string",
"description": "搞笑=gxmy,字谜=zmmy,成语=cymy,动物=dwmy,爱情=aqmy,灯谜=dmmy,人名=rmmy,地名=dimmy,词语=cy,带格=dgmy,用语=ry,儿童=etmy,物品=wpmy,植物=zwmy,名谜=jmmy,书报=sbmy,俗语=symy,药品=ypmy,音乐=yymy,影视=ysmy,称谓=cwmy,趣味=qtmy,精选=miyujingxuan, 脑筋急转弯=njmy,智力问答=zlmy"
}
}
}
}
}
}
}
}
},
"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/151?tab=book"
},
"x-apiCode": "151",
"x-is-own": false,
"x-is-op": true
}